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A shielded cable is a cable that uses a 
metallic wrap aroun d the wires to reduce 
the potential effects of radio frequency 
interference. 


Radio and Television Interference 


The equipment described in this manual generates and uses 
radio-frequency energy. If it is not installed and used properly—that is, in 
strict accordance with our instructions—it may cause interference with 
radio and television reception. 


This equipment has been tested and complies with the limits for a Class B 
computing device in accordance with the specifications in Subpart J, 

Part 15, of FCC rules. These rules are designed to provide reasonable 
protection against such interference in a residential installation. However, 
there is no guarantee that the interference will not occur in a particular 
installation, especially if a “rabbit ear” television antenna is used. (A “rabbit 
ear” antenna is the telescoping-rod type usually contained on television 
receivers. ) 


You can determine whether your computer is causing interference by 
turning it off. If the interference stops, it was probably caused by the 
computer or its peripherals. To further isolate the problem, disconnect the 
peripheral devices and their input/output cables one at a time. If the 
interference stops, it was caused by either the peripheral device or the I/O 
cable. These devices usually require shielded I/O cables. For Apple 
peripherals, you can obtain the proper shielded cable from your dealer. 
For non-Apple peripheral devices, contact the manufacturer or dealer for 
assistance. 


If your computer does cause interference to radio or television reception, 
you can try to correct the interference by using one or more of the following 
measures: 


o Turn the television or radio antenna until the interference stops. 
O Move the computer to one side or the other of the television or radio. 
O Move the computer farther away from the television or radio. 
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oO Plug the computer into an outlet that is on a different circuit than the 
television or radio. (That is, make certain the computer and the radio or 
television set are on circuits controlled by different circuit breakers or 
fuses. ) 

O Consider installing a rooftop television antenna with coaxial cable lead-in 
between the antenna and television. 


If necessary, you should consult your Apple-authorized dealer or an 
experienced radio/television technician for additional suggestions. 
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About This Manual 


This is the reference manual for the Apple Ile personal computer. It 
contains detailed descriptions of all of the hardware and firmware that 
make up the Apple Ile and provides the technical information that 
peripheral-card designers and programmers need. 


This manual contains a lot of information about the way the Apple Ile 
works, but it doesn’t tell you how to use the Apple Ile. For this, you should 
read the other Apple Ile manuals, especially the following: 


Oo Apple Ile Owner’s Manual 
oO The Applesoft Tutorial 


Contents of This Manual 


Tee SSS a ee a ea ae he Ce ae ee we 


The material in this manual is presented roughly in order of increasing 
intimacy with the hardware; the farther you go in the manual, the more 
technical the material becomes. The main subject areas are 


oO introduction: Preface and Chapter 1 

o use of built-in features: Chapters 2 and 3 

O how the memory is organized: Chapter 4 

O information for programmers: Chapters 5 and 6 

O hardware implementation: Chapter 7 

O additional information: appendixes, glossary, and bibliography. 


Chapter 1 identifies the main parts of the Apple Ile and tells where in the 
manual each part is described. 


The next two chapters describe the built-in input and output features of the 
Apple Ile. This part of the manual includes information you need for 
low-level programming on the Apple Ile. Chapter 2 describes the built-in 1/0 
features and Chapter 8 tells you how to use the firmware that supports 
them. 
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XXVIli 


Chapter 4 describes the way the Apple IIe’s memory space is organized, 
including the allocation of programmable memory for the video display 
buffers. 


Chapter 5 is a user manual for the Monitor that is included in the built-in 
firmware. The Monitor is a system program that you can use for program 
debugging at the machine level. 


Chapter 6 describes the programmable features of the peripheral-card 
connectors and gives guidelines for their use. It also describes interrupt 
programming on the Apple Ile. 


Chapter 7 is a description of the hardware that implements the features 
described in the earlier chapters. This information is included primarily for 
programmers and peripheral-card designers, but it will also help you if you 
just want to understand more about the way the Apple Ile works. 


Additional reference information appears in the appendixes. Appendix A is 
the manufacturer’s description of the Apple Ile’s microprocessor. 


Appendix B is a directory of the built-in I/O subroutines, including their 
functions and starting addresses. 


Appendix C describes differences among Apple II family members. 


Appendix D describes some of the operating systems and languages 
supported by Apple Computer for the Apple Ile. 


Appendix E contains conversion tables of interest to programmers. 


Appendix F contains additional copies of some of the tables that appear in 
the body of the manual. The ones you will need to refer to often are 
duplicated here for easy reference. 


Appendix G contains information about using Apple Ile 80-column text 
cards with the Apple Ile and high level languages. 


Appendix H discusses programming on the Apple Ile with the Apple Super 
Serial Card. 


Appendix I| contains the source listing of the Monitor firmware. You can 
refer to it to find out more about the operation of the Monitor subroutines 
listed in Appendix B. 


Following Appendix I is a glossary defining many of the technical terms 
used in this manual. Some terms that describe the use of the Apple Ile are 
defined in the glossaries of the other manuals listed earlier. 


Following the glossary, there is a selected bibliography of sources of 
additional information. 
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The Enhanced Apple lle 

TO EES SS a ae ee ee ee ee ee eee) 
Changes have been made in the Apple Ile since the original version was 
introduced. The new version is called the enhanced Apple Ile and is 
described in this manual. Where there are differences in the original 
Apple Ile compared with the enhanced Apple Ile, they will be called out in 
the manual. Otherwise, the two machines operate identically. 


You can tell whether you have an original or enhanced Apple Ile when you 
start up the system. An original Apple [le will display Apple 1¢ at the top 
of the monitor screen, while an enhanced Apple Ile will display 

Apple //e. 


The changes embodied in the enhanced Apple IIe are described in the 
following sections of this preface. 


Physical Changes 
SaaS ee 


The enhanced Apple Ile includes the following changes from the original 
Apple Ile: 


Oo The 65C02 microprocessor, which is a new version of the 6502 
microprocessor found in the original Apple Ile. The 65C02 uses less 


Opcode is short for operation code and is power, has 27 new opcodes, and runs at the same speed as the 6502. 
used to describe the basic instructions (See Chapter 7 and Appendix A.) 
eons meena eis a Mer o Anew video ROM containing the same MouseText characters found in 


the Apple IIc. (See Chapter 2. ) 

oc New Monitor ROMs (the CD and EF ROMs) containing the enhanced 
Apple Ile firmware. (See Chapter 5.) 

co The identification byte at $FBCO has been changed. In the original 


Apple Ile it was $A (decimal 234), in the enhanced Apple Ile it is $E0 
(decimal 224). 


Startup Drives 


You can use startup (boot) devices other than a Disk II to start up ProDOS 
on the enhanced Apple Ile. 


Apple II Pascal versions 1.3 and later may start up from slots 4, 5, or 6 on a 
Disk II, ProFile, or other Apple II disk drive. Apple II Pascal versions 1.0 
through 1.2 must start up from a Disk II in slot 6. 


DOS 3.38 may be started from a Disk II in any slot. 


The Enhanced Apple Ile x 


XXX 


When you turn on your Apple Ile, it searches for a disk drive controller to 
start up from, beginning with slot 7 and working down toward slot 1. As 
soon as a disk controller card is found, the Apple Ile will try to load and 
execute the operating system found on the disk. If the drive is not a Disk II, 
then the operating system of the startup volume must be either ProDOS or 
Apple II Pascal (version 1.3 or later). If it is a Disk II, then the startup 
volume may be any Apple II operating system. 


Video Firmware 
i er re) 


The enhanced Apple Ile has improved 80-column firmware: 


oO The enhanced Apple Ile now supports lowercase input. 


Oo [E] passes most control characters to the screen. 


oO traps most control characters before they get to the 
screen. 


Oo [R] was removed because uppercase characters are no longer 
required by Applesoft. 


Video Enhancements 


Both 80-column Pascal and 80-column mode Applesoft output are faster 
than before and scrolling is smoother. 40-column Pascal performance is 
unchanged. 


In the original Apple IIe, characters echoed to COUT1 during 80-column 
operation were printed in every other column; the enhanced Apple Ile 
firmware now prints the characters in each column. 


Applesoft 80-Column Support 
Se ee en eee 


The following Applesoft routines now work in 80-column mode: 


oO HTAB 

oO TAB 

oO SPC 

oO Comma tabbing in PRINT statements 
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To find out more, see the Pascal ProFile 
Manager Manual. 


Applesoft Lowercase Support 


SS ee ee ee ee ee ater eaet 

Applesoft now lets you do all your programming in lowercase. When you list 
your programs, all Applesoft keywords and variable names automatically 
are in uppercase characters; literal strings and the contents of DATA and 
REM statements are unchanged. 


Appie Il Pascal 


EEE SS ee 
Apple II Pascal (version 1.2 and later) can now use a ProFile hard disk 
through the Pascal ProFile Manager. 


The Pascal 1.1 firmware no longer supports the control character that 
switches from 80-column to 40-column operation. This control character is 
no longer supported because it can put Pascal in a condition where the 
exact memory configuration is not known. 


System Monitor Enhancements 


Enhancements to the Apple Ile’s built-in Monitor (described in Chapter 5 in 
this manual) include the following: 


O lowercase input 

O ASCII input mode 

oO Monitor Search command 
oO the Mini-Assembler 


Interrupt Handling 
SS SSS SS SS 


Interrupt handler support in the enhanced Apple Ile firmware now handles 
any Apple Ile memory configuration. 
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Symbols Used in This Manual 

0 See ee ee ee ee ee eS as 
Special text in this manual is set off in several different ways, as shown in 
these examples. 


AWarning | Important warnings appear in red like this. These flag potential danger to 
the Apple Ile, its software, or you. 


which the original Apple Ile differs from the enhanced Apple IIe are 


Important! The information here is important, but non-threatening. The ways in 
called out this way with the tag Original IIe in the margin. 


By the Way: Information that is useful but is incidental to the text is set 
off like this. You may want to skip over such information and return to it 


Definitions, cross-references, and other later. 

short items appear in marginal glosses like 

this. Terms that are defined in a marginal gloss or in the glossary appear in 
boldface. 


XXXII Preface: About This Manual 


Chapter | Introduction 


This first chapter introduces you to the Apple Ile itself. It shows you what 
the inside looks like, identifies the major components that make up the 
machine, and tells you where to find information about each one. 


Removing the Cover 

Eee SESE ————E—————————————e a | 
Remove the cover of the Apple Ile by pulling up on the back edge until the 
fasteners on either side pop loose, then move the cover an inch or so toward 
the rear of the machine to free the front of the cover, as shown in Figure 1-1. 
What you will see is shown in Figure 1-2. 


Figure 1-1. Removing the Cover Figure 1-2. The Apple Ile With the Cover Off 
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AWarning There is a red LED (light-emitting diode) inside the Apple Ile, in the left 
rear corner of the circuit board. If the LED is on, it means that the power 
is on and you must turn it off before you insert or remove anything. To 
avoid damaging the Apple Ile, don’t even think of changing anything 
inside it without first turning off the power. 


The Keyboard 


a ae ee | 


The keyboard is the Apple Ile’s primary input device. As shown in 
Figure 1-3, it has a normal typewriter layout, uppercase and lowercase, with 


ASCII stands for American Code for all of the special characters in the ASCII character set. The keyboard is 

Information Interchange. fully integrated into the machine; its operation is described in the first part 
of Chapter 2. Firmware subroutines for reading the keyboard are described 
in Chapter 3. 


Figure 1-3. The Apple Ile Keyboard 


The Speaker 

NNT ee ee ene eee 
The Apple Ile has a small loudspeaker in the bottom of the case. The 
speaker enables Apple Ile programs to produce a variety of sounds that 
make the programs more useful and interesting. The way programs control 
the speaker is described in Chapter 2. 
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The Power Supply 

RMR a a ee 
The power supply is inside the flat metal box along the left side of the 
interior of the Apple Ile. It provides power for the main board and for any 
peripheral cards installed in the Apple Ile. 


The power supply produces four different voltages: +5V, -5V, +12V, and 
-12V. It is a high-efficiency switching supply; it includes special circuits that 
protect it and the rest of the Apple Ile against short circuits and other 
mishaps. Complete specifications of the Apple Ile power supply appear in 
Chapter 7. 


AWarning The power switch and the socket for the power cord are mounted directly 
on the back of the power supply’s metal case. This mounting ensures that 
all the circuits that carry dangerous voltages are inside the power supply. 
Do not defeat this design feature by attempting to open the power supply. 


The Circuit Board 

ee NET ee eee ————————— 
All of the electronic parts of the Apple Ile are attached to the circuit board, 
which is mounted flat in the bottom of the case. 


Figure 1-4 shows the main integrated circuits (ICs) in the Apple IIe. They 
are the central processing unit (CPU), the keyboard encoder, the keyboard 
read-only memory (ROM), the two interpreter ROMs, the video ROM, and 
the custom integrated circuits: the Input/Output Unit (OU), the Memory 
Management Unit (MMU), and the Programmed Array Logic (PAL) device. 
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Figure 1-4. The Circuit Board 
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The CPU is a 65C02 microprocessor. The 65C02 is an enhanced version of 
the 6502, which is an eight-bit microprocessor with a sixteen-bit address 
bus. It uses instruction pipelining for faster processing than comparable 
microprocessors. In the Apple Ile, the 65C02 runs at 1.02 MHz and performs 
up to 500,000 eight-bit operations per second. The specifications of the 
65C02 and its instruction set are given in Appendix A. 


The original version of the Apple Ile uses the 6502 microprocessor. You can 
tell which version of Apple Ile that you have by starting up your machine. 
An original Apple Ile displays Apple 1¢ at the top of the screen during 
startup, while an enhanced Apple Ile displays Apple //e. This manual 
will call out specific areas where the two versions of the Apple Ile are 
different. 


Original Ile | The 6502 is very similar to the 65C02, but lacks 10 instructions and 2 
addressing modes found on the 65C02. The 6502 is an NMOS device and 
sO uses more power than the CMOS 65C02. Except for the differences 
listed above, and some minor differences in the number of clock cycles 
used by some instructions, the two microprocessors are identic al. 


The keyboard is decoded by an AY-3600-type integrated circuit and a 
read-only memory (ROM). These devices are described in Chapter 7. 


The interpreter ROMs are integrated circuits that contain the Applesoft 
BASIC interpreter. The ROMs are described in Chapter 7. The Ap plesoft 
language is described in the Applesoft Tutorial and the Applesoft BASIC 
Programmer's Reference Manual. 


Two of the large ICs are custom-made for the Apple IIe: the MMU and the 
JOU. The MMU IC contains most of the logic that controls memory 
addressing in the Apple Ile. The organization of the memory is described in 
Chapter 4: the circuitry in the MMU itself is described in Chapter 7. 


The JOU IC contains most of the logic that controls the built-in input/output 
features of the Apple Ile. These features are described in Chapter 2 and 
Chapter 3; the IOU circuits are described in Chapter 7. 


Connectors on the Circuit Board 

I EE EE EEE SSS SS Se ee ee aes 
The seven slots lined up along the back of the Apple Ile circuit board are the 
expansion slots, sometimes called peripheral slots. (See Figure 1-5.) These 
slots make it possible to attach additional hardware to the Apple Ile. 
Chapter 6 tells you how your programs deal with the devices that plug into 
these slots; Chapter 7 describes the circuitry for the slots themselves. 
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Figure 1-5. The Expansion Slots 
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The large slot next to the left-hand side of the circuit board is the auxiliary 
slot (Figure 1-6). If your Apple [le has an Apple IIe 80-column text card, it 
will be installed in this slot. The 80-column display option is fully integrated 
into the Apple Ile; it is described along with the other display features in 
Chapter 2. The hardware and firmware interfaces to this card are described 
in Chapter 7. 


Figure 1-6. The Auxiliary Slot 
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There are also smaller connectors for game I/O and for an internal RF 
(radio frequency ) modulator. These connectors are described in Chapter 7. 
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Connectors on the Back Panel 

a ae a a eR ea ee a 
The back of the Apple Ile has two miniature phone jacks for connecting a 
cassette recorder, an RCA-type jack for a video monitor, and a 9-pin D-type 
miniature connector for the hand controls, as shown in Figure 1-7. In 
addition to these, there are spaces for additional connectors used with the 
peripheral cards installed in the Apple Ile. The installation manuals for the 
peripheral cards contain instructions for installing the peripheral 
connectors. 


Figure 1-7. The Back Panel Connectors 
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Chapter 2 


Built-in I/O Devices 


For descriptions of the built-in I/O 
hardware refer to Chapter 7. 


Built-in 1/0 firmware routines are 
described in Chapter 3. 


This chapter describes the input and output (1/0) devices built into the 
Apple Ile in terms of their functions and the way they are used by 
programs. The built-in I/O devices are 


the keyboard 

the video-display generator 
the speaker 

the cassette input and output 
the game input and output. 


Oodadda 0 


At the lowest level, programs use the built-in I/O devices by reading and 
writing to dedicated memory locations. This chapter lists these locations for 
each I/O device. It also gives the locations of the internal soft-switches that 
select the different display modes of the Apple Ile. 


Built-in I/O Routines: This method of input and output—loading and 
storing directly to specific locations in memory—is not the only method 
you can use. For many of your programs, it may be more convenient to 
call the built-in I/O routines stored in the Apple Ile’s firmware. 


The Keyboard 


FE ae a ee ee ee eee 


The primary input device of the Apple Ile is its built-in keyboard. The 
keyboard has 68 keys and is similar to a typewriter keyboard. The Apple Ile 
keyboard has automatic repeat on all keys: hold the key down to repeat. It 
also has N-key rollover, which means that you can hold down any number 
of keys while typing another. Of course, if you hold the keys down much 
longer than the length of time you would hold them down during normal 
typing, the automatic-repeat function will start repeating the last key you 
pressed. 


The keyboard arrangement shown in Figure 2-1 is the standard one used in 
the United States. The specifications for the keyboard are given in 

Table 2-1. Apple IIe’s manufactured for sale outside the United St ates have 
a slightly different standard keyboard arrangement and include provisions 
for switching between two different arrangements. 
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Figure 2-1. The Keyboard 


CAPS 


Table 2-1. Apple Ife Keyboard Specifications 


Number of keys: 63 

Character encoding: ASCII 

Number of codes: 128 

Features: Automatic repeat, two-key rollover 


Special function keys: (RESET ], (G], (#] 
Cursor movement Keys: (~),(),@), (4), (RETURN), (DELETE), 


Modifier keys: [CONTROL }, [SHIFT], [CAPS LOCK], 
Electrical Interface: AY-5-3600 keyboard encoder 


In addition to the keys normally used for typing characters, there are four 
cursor-control keys with arrows: left, right, down, and up. The 
cursor-control keys can be read the same as other keys; their codes are $08, 
$15, $0A, and $0B. (See Table 2-3.) 


Three special keys, [CONTROL ], (SHIFT ], and (CAPS LOCK], change the 
codes generated by the other keys. The key is similar to the 
ASCII CTRL Key. 


Three other keys have special functions: the key, and two keys 
marked with apples, one outlined, or open ((G}), and one solid, or closed 
((é]). Pressing the key with the key depressed resets 
the Apple Ile, as described in Chapter 4. The Apple keys are connected to 
the one-bit game inputs, described later in this chapter. 


The Keyboard 1] 


See Chapter 7 for a complete description of 
the elecrtical interface to the keyboard. 


Hexadecimal refers to the base-16 number 
system, which uses the digits 0 through 9 
and the six letters A through F to represent 
values from 0 to 15. 


12 


The electrical interface between the Apple Ile and the keyboard is a ribbon 
cable with a 26-pin connector. This cable carries the keyboard signals to the 
encoding circuitry on the main board. 


Reading the Keyboard 


S=S SSS 

The keyboard encoder and ROM generate all 128 ASCII codes, so all of the 
special character codes in the ASCII character set are available from the 
keyboard. Machine-language programs obtain character codes from the 
keyboard by reading a byte from the keyboard-data location shown in 
Table 2-2. 


Table 2-2. Keyboard Memory Locations 


Location 
Hex Decimal Description 


$C000 49152 -16384 Keyboard data and strobe 
$C010 49168 -16368 Any-key-down flag and clear-strobe switch 


Your programs can get the code for the last key pressed by readin g the 
keyboard-data location. Table 2-2 gives this location in three diffe rent 
forms: the hexadecimal value used in assembly language, indicated by a 
preceding dollar sign ($); the decimal value used in Applesoft BASIC, and 
the complementary decimal value used in Apple Integer BASIC. ( Integer 
BASIC requires that values greater than 32767 be written as the mumber 
obtained by subtracting 65536 from the value. These are the decimal 
numbers shown as negative in tables in this manual; refer to the A pple J] 
BASIC Programming Manual.) The low-order seven bits of the byte at 
the keyboard location contain the character code; the high-order bit of this 
byte is the strobe bit, described later in this section. 


Your program can find out whether any key is down, except the (RESET ], 
[CONTROL }, [SHIFT], (CAPS LOCK], (c], and (é] keys by reading from 
location 49168 (hexadecimal $C010 or complementary decimal -16368). The 
high-order bit (bit 7) of the byte you read at this location is called 
any-key-down, it is 1 if a key is down, and 0 if no key is down. The value of 
this bit is 128; if a BASIC program gets this information with a PEEK, the 
value is 128 or greater if any key is down, and less than 128 if no Key is 
down. 
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important! 


The reset routine is de scribed in Chapter 4. 


The (G] and (#] keys are connected to switches 0 and 1 of the game I/O 
connector inputs. If [G]is pressed, switch 0 is “pressed,” and if (é)is 
pressed, switch 1 is “pressed.” 


The strobe bit is the high-order bit of the keyboard-data byte. After any key 
has been pressed, the strobe bit is high. It remains high until you reset it by 
reading or writing at the clear-strobe location. This location is a combination 
flag and switch; the flag tells whether any key is down, and the switch 
clears the strobe bit. The switch function of this memory location is called a 
soft switch because it is controlled by software. In this case, it doesn’t 
matter whether the program reads or writes, and it doesn’t matter what 
data the program writes: the only action that occurs is the resetting of the 
keyboard strobe. Similar soft switches, described later, are used for 
controlling other functions in the Apple Ile. 


Any time you read the any-key-down flag, you also clear the keyboard 
strobe. If your program needs to read both the flag and the strobe, it must 
read the strobe bit first. 


After the keyboard strobe has been cleared, it remains low until another key 
is pressed. Even after you have cleared the strobe, you can still read the 
character code at the keyboard location. The data byte has a different 
value, because the high-order bit is no longer set, but the ASCII code in the 
seven low-order bits is the same until another Key is pressed. Table 2-38 
shows the ASCII codes for most of the keys on the keyboard of the 

Apple Ile. 


There are several special-function keys that do not generate ASCII codes. 
For example, you cannot read the [CONTROL |, (SHIFT ], and 
keys directly, but pressing one of these Keys alters the character codes 
produced by the other keys. 


Another key that doesn’t generate a code is (RESET ], located at the 
upper-right corner of the keyboard; it is connected directly to the Apple Ile’s 
circuits. Pressing with depressed normally causes the 
system to stop whatever program it’s running and restart itself. This 
restarting process is called the reset routine. 


Two more special keys are the Apple keys, (G] and (6), located on either 
side of the bar. These keys are connected to the one-bit game 
inputs, which are described later in this chapter in the section “Switch 
Inputs.” Pressing them in combination with the and 
keys causes the built-in firmware to perform special reset and self-test 
cycles, described with the reset routine in Chapter 4. 
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Table 2-3. Keys and ASCII Codes 


Note: Codes are shown here in hexadecimal; to find the decimal equivalents, refer 


Normal Control Shift Both 

Key Code Char Code Char Code Char Code Char 
(F DEL (F DEL iF DEL (F DEL 
08 BS 08 BS 08 BS 08 BS 

TAB 09 HT 09 HT 09 HT 09 HT 
G] OA LF OA LF OA LF OA LF 
[+] OB VT OB VT OB VT OB VT 
OD CR OD CR OD CR OD CR 
15 NAK 15 NAK 15 NAK 15 NAK 
1B ESC 1B ESC 1B ESC 1B ESC 
20 SP 20 SP 20) SP 20) SP 


™ 27 7A | 22 : 22 
a4 2C ; 2C : 3C < 3C < 
a 2D : 1F US 5F = IF US 
> 2E 2E 3 > 3k > 
12 oF O/ OF / SF? 3F ? 
0 ) 30 0 30 0 29 ) 29 ) 
1! 31 1 3] l 2] | 21 ! 
2@ 32 00 NUL 40 @ 00 NUL 
3 # 33 3 33 3 23 # as # 
4 $ 84 4 34 4 24 $ 24 $ 
5% 35 5 35 5 25 % 25 % 
6° 36 6 1E  ~=RS 5E ° 1E RS 
7& of (i 37 (i 26 & 26 & 
8 * 38 8 38 8 2A : 2A i 
9 ( 39 9 39 9 28 ( 28 ( 
3B 3B 3A 3A 
= + 3D = 3D = 2B + 2B aa 
[{ 5B 1B ESC 7B { 1B ESC 
\| 5C 1C FS le | 1C FS 
}} 5D 1D GS 7D } 1D GS 
: 60 ; 60 ; TE " TE : 
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Table 2-3—Continued. Keys and ASCII Codes 


Note: Codes are shown here in hexadecimal, to find the decimal equivalents, refer 


to Table E-2. 


Normal 


Code 


61 
62 
63 
64 
65 
66 
67 
68 
69 
6A 
6B 
6C 
6D 
65 
oF 
70 
71 
72 
73 
74 
15 
76 
(7 
78 
79 
TA 


A 
@ 
<q 


New Sexe CHA nwWOVOAZMTIASC TAO BPABITAxvS 
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Char 


N@ 4 ¢< ertnrowos Fro roe oma oO eT 


Control 
Code Char 
01 SOH 
02 STX 
03 ETX 
04 EOT 
05 ENQ 
06 ACK 
07 BEL 
08 BS 
09 HT 
OA LF 
OB VT 
OC FF 
OD CR 
OE SO 
OF SI 
10 DLE 
ll DC1 
12 DC2 
13 DC3 
14 DC4 
15 NAK 
16 SYN 
17 ETB 
18 CAN 
19 EM 
1A SUB 


Code 


4] 
42 
43 
a 
45 
46 
47 
48 
49 
4A 
4B 
4C 
4D 
4h 
4F 
50) 
ol 
Oz 
53 
o4 
DO 
56 
of 
58 
og 
DA 


Shift 
Char 


ee 2 eS OO SP EB 


Code 


01 
02 
03 
04 
05 
06 
07 
08 
09 
OA 
OB 
0C 
OD 
OE 
OF 
10 
1] 
12 
13 
14 
15 
16 
17 
18 
19 
1A 


Both 


Char 


SOH 
STX 
ETX 
KOT 
ENQ 
ACK 
BEL 
BS 
HT 
LF 
VT 
FF 
CR 
SO 
SI 
DLE 
DC1 
DC2 
DC3 
DC4 
NAK 
SYN 
ETB 
CAN 
KM 
SUB 


The Video Display Generator 

ee ea i ee Se ee 
The primary output device of the Apple Ile is the video display. You can use 
any ordinary video monitor, either color or black-and-white, to display video 
information from the Apple IIe. An ordinary monitor is one that accepts 
composite video compatible with the standard set by the NTSC (National 
Television Standards Committee). If you use Apple Ile color graphics with a 
black-and-white monitor, the display will appear as black and white (or 
green or amber or...) and various patterns of these two shades mixed 
together. 


If you are using only 40-column text and graphics modes, you can use a 
television set for your video display. If the TV set has an input connector for 
composite video, you can connect it directly to your Apple IIe; if it does not, 
you'll need to attach a radio frequency (RF) video modulator between the 
Apple Ile and the television set. 


Important! With the 80-column text card installed, the Apple Ile can produce an 
80-column text display. However, if you use an ordinary color or 
black-and-white television set, 80-column text will be too blurry to read. 
For a clear 80-column display, you must use a high-resolution video 
monitor with a bandwidth of 14 MHz or greater. 


The specifications for the video display are summarized in Table 2-4. 


Original Ile | Note that MouseText characters are not included in the original version 
of the Apple Ile. 


The video signal produced by the Apple Ile is NT'SC-compatible composite 
color video. It is available at three places: the RCA-type phono jack on the 
For a full description of the video signal back of the Apple Ile, the single Molex-type pin on the main circuit board 
and the connections to the Molex-type pins, near the back on the right side, and one of the group of four Molex-type pins 
: sot hae Video Output Signals” —_ in the same area on the main board. Use the RCA-type phono jack to 
ee connect a video monitor or an external video modulator; use the Molex pins 
to connect the type of video modulator that fits inside the Apple Ile case. 
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Table 2-4. Video Display Specifications 


Display modes: 40-column text; map: Figure 2-5 
80-column text; map: Figure 2-6 


Low-resolution color graphics; map: Figure 2-7 
High-resolution color graphics; map: Figure 2-8 


Double-high-res. color graphics; map: Figure 2-9 


Text capacity: 24 lines by 80 columns (character positions) 
Character set: 96 ASCII characters (uppercase and lowercase) 
Display formats: Normal, inverse, flashing, MouseText (Table 2-5) 


Low-resolution graphics: 16 colors (Table 2-6) 40 horizontal by 48 vertical; 
map: Figure 2-7 


High-resolution graphics: 6 colors (Table 2-7) 140 horizontal by 192 vertical 
(restricted) 


Black-and-white: 280 horizontal by 192 vertical: 
map: Figure 2-8 


Double-high-resolution 16 colors (Table 2-8) 140 horizontal by 192 vertical 
graphics: (no restrictions ) 


Black-and-white: 560 horizontal by 192 vertical; 
map: Figure 2-9 


The Apple Ile can produce seven different kinds of video display: 


Oo text, 24 lines of 40 characters 

O text, 24 lines of 80 characters (with optional text card) 

oO low-resolution graphics, 40 by 48, in 16 colors 

o high-resolution graphics, 140 by 192, in 6 colors 

m high-resolution graphics, 280 by 192, in black and white 

o double high-resolution graphics, 140 by 192, in 16 colors (with optional 
64K text card) 

oO double high-resolution graphics, 560 by 192, in black and white (with 
optional 64K text card) 


The two text modes can display all 96 ASCII characters: the uppercase and 
lowercase letters, numbers, and symbols. The enchanced Apple Ile can also 
display MouseText characters. 
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Any of the graphics displays can have 4 lines of text at the bottorn of the 
screen. The text may be either 40-column or 80-column, except that 
double-high-resolution graphics may only have 80-column text at the 
bottom of the screen. Graphics displays with text at the bottom are called 
mixed-mode displays. 


The low-resolution graphics display is an array of colored blocks, 40 wide by 
48 high, in any of 16 colors. In mixed mode, the 4 lines of text replace the 
bottom 8 rows of blocks, leaving 40 rows of 40 blocks each. 


The high-resolution graphics display is an array of dots, 280 wide by 192 
high. There are 6 colors available in high-resolution displays, but a given dot 
can use only 4 of the 6 colors. In mixed mode, the 4 lines of text replace the 
bottom 32 rows of dots, leaving 160 rows of 280 dots each. 


The double-high-resolution graphics display uses main and auxiliary 
memory to display an array of dots, 560 wide by 192 high. All the dots are 
visible in black and white. If color is used, the display is 140 dots wide by 
192 high with 16 colors available. In mixed mode, the 4 lines of text replace 
the bottom 82 rows of dots, leaving 160 rows of 560 (or 140) dots each. In 
mixed mode, the text lines can be 80 columns wide only. 


Text Modes 


The text characters displayed include the uppercase and lowercase letters, 
the ten digits, punctuation marks, and special characters. Each character 1s 
displayed in an area of the screen that is seven dots wide by eight dots high. 
The characters are formed by a dot matrix five dots wide, leaving two blank 
columns of dots between characters in a row, except for MouseText 
characters, some of which are seven dot wide. Except for lowercase letters 
with descenders and some MouseText characters, the characters are only 
seven dots high, leaving one blank line of dots between rows of characters. 


The normal display has white (or other single color) dots on a black 
background. Characters can also be displayed as black dots on a white 
background; this is called inverse format. 
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Text Character Sets 


The Apple Ile can display either of two text character sets: the primary set 
or an alternate set. The forms of the characters in the two sets are actually 
the same, but the available display formats are different. The display 
formats are 


O normal, with white dots on a black screen 
O inverse, with black dots on a white screen 
oO flashing, alternating between normal and inverse. 


With the primary character set, the Apple Ile can display uppercase 
characters in all three formats: normal, inverse, and flashing. Lowercase 
letters can only be displayed in normal format. The primary character set is 
compatible with most software written for the Apple I] and Apple II Plus 
models, which can display text in flashing format but don’t have lowercase 
characters. 


The alternate character set displays characters in either normal or inverse 
format. In normal format, you can get 


O uppercase letters 

O lowercase letters 

O numbers 

O special characters. 


In inverse format, you can get 


oO MouseText characters (on the enhanced Apple Ile) 
O uppercase letters 

o lowercase letters 

O numbers 

O special characters. 


The MouseText characters that replace the alternate uppercase inverse 
characters in the range of $40-$5F in the original Apple Ile are inverse 
characters, but they don’t look like it because of the way that they have 
been constructed. 


You select the character set by means of the alternate-text soft switch, 
ALTCHAR, described later in the section “Display Mode Switching.” 
Table 2-5 shows the character codes in hexadecimal for the Apple Ile 
primary and alternate character sets in normal, inverse, and flashing 
formats. 
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20 


Original lle 


Each character on the screen is stored as one byte of display data. The 
low-order six bits make up the ASCII code of the character being displayed. 
The remaining two (high-order) bits select inverse or flashing format and 
uppercase or lowercase characters. In the primary character set, bit 7 
selects inverse or normal format and bit 6 controls character flashing. In the 
alternate character set, bit 6 selects between uppercase and lowercase, 
according to the ASCII character codes, and flashing format is not available. 


Table 2-5. Display Character Sets 


Note: To identify particular characters and values, refer to Table 2-3. 


Hex Primary Character Set Alternate Character Set 

Values Character Type Format Character Type Format 
$00-$1F Uppercase letters Inverse Uppercase letters Inverse 
$20-$3F Special characters _—_ Inverse Special characters — Inverse 


$40-$5F Uppercase letters Flashing § MouseText 

$60-$7F Special characters Flashing — Lowercase letters Inverse 
$80-$9F Uppercase letters Normal Uppercase letters Normal 
$A0-$BF Special characters Normal Special characters § Normal 
$C0-$DF Uppercase letters Normal Uppercase letters Normal 


$K0-$FF Lowercase letters Normal Lowercase letters Normal 


In the alternate character set of the original Apple Ile, characters in the 
range $40-$5F are uppercase inverse. 


40-Column Versus 80-Column Text 


The Apple Ile has two modes of text display: 40-column and 80-column. 
(The 80-column display mode described in this manual is the one you get 
with the Apple IIe 80-Column Text Card or other auxiliary-memory card 
installed in the auxiliary slot.) The number of dots in each character does 
not change, but the characters in 80-column mode are only half as wide as 
the characters in 40-column mode. Compare Figure 2-2 and Figure 2-3. On 
an ordinary color or black-and-white television set, the narrow characters in 
the 80-column display blur together; you must use the 40-column mode to 
display text on a television set. 
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Figure 2-2. 40-Column Text Display 


JLIST 6,108 
18 REM APPLESOFT CHARACTER DEMO 


26 TEXT : HOME 

36 PRINT : PRINT “Applesoft char 
acter Demo" 

46 PRINT : PRINT “Which characte 
r set--" 

S@ PRINT : INPUT “Primary CP) or 
Alternate CA) ?";A$ 

60 IF LEN CA$) < 1 THEN 58 

6S LET A$ = LEFT$ CA$,1) 

76 IF A$ = "P" THEN POKE 49166, 
') 

86 IF A$ = "A" THEN POKE 49167, 
0 

98 PRINT : PRINT "...printing th 
e same line, first" 

188 PRINT ™ in NORMAL, then INVE 
RSE ,then FLASH:": PRINT 

] 


Figure 2-8. 80-Column Text Display 
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REM APPLESOFT CHARACTER DEMO 
TEXT : HOME 
PRINT : PRINT “Applesoft Character Demo" 
PRINT : PRINT “Which character set--" 
PRINT : INPUT “Primary CP) or Alternate CA) ?";A$ 
IF LEN CA$) < 1 THEN 5S@ 
LET A$ = LEFT$ CA$, 1) 
IF A$ = "P** THEN POKE 49166,86 
IF A$ = “A™ THEN POKE 49167,86 
PRINT : PRINT "...printing the same line, first" 
PRINT * in NORMAL, then INVERSE ,then FLASH:": PRINT 
NORMAL : GOSUB 186690 
INVERSE : GOSUB 1868 
FLASH : GOSUB 1008 
NORMAL : PRINT : PRINT : PRINT “Press any key to repeat.” 
GET A$ 
GOTO 18 
9 PRINT : PRINT “SAMPLE TEXT: Now is the time--12:090" 
8 RETURN 
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Graphics Modes 


———————S=SS = ae 

The Apple Ile can produce video graphics in three different modes. All the 
graphics modes treat the screen as a rectangular array of spots. Normally, 
your programs will use the features of some high-level language to draw 
graphics dots, lines, and shapes in these arrays; this section describes the 
way the resulting graphics data are stored in the Apple Ile’s memory. 


Low-Resolution Graphics 


In the low-resolution graphics mode, the Apple Ile displays an array of 48 
rows by 40 columns of colored blocks. Each block can be any one of sixteen 
colors, including black and white. On a black-and-white monitor or 
television set, these colors appear as black, white, and three shades of gray. 
There are no blank dots between blocks; adjacent blocks of the same color 
merge to make a larger shape. 


Data for the low-resolution graphics display is stored in the same part of 
memory as the data for the 40-column text display. Each byte contains data 
for two low-resolution graphics blocks. The two blocks are displayed one 
atop the other in a display space the same size as a 40-column text 
character, seven dots wide by eight dots high. 


Half a byte—four bits, or one nibble—is assigned to each graphics block. 
Each nibble can have a value from 0 to 15, and this value determines which 
one of sixteen colors appears on the screen. The colors and their 
corresponding nibble values are shown in Table 2-6. In each byte, the 
low-order nibble sets the color for the top block of the pair, and the 
high-order nibble sets the color for the bottom block. Thus, a byte 
containing the hexadecimal value $D8 produces a brown block atop a 
yellow block on the screen. 
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Table 2-6. Low-Resolution Graphics Colors 


Note: Colors may vary, depending upon the controls on the monitor or TV set. 


Nibble Value Nibble Value 
Dec Hex Color Dec Hex Color 
0 $00 Black 8 $08 Brown 
1 $01 Magenta 9 $09 Orange 
2 $02 Dark Blue 10 $0A Gray 2 
3 $03 Purple ll $0B _—~wPink 
4 $04 Dark Green 12 $0C _— Light Green 
5 $05 Gray | 13 $0D Yellow 
6 $06 Medium Blue 14 $0E Aquamarine 
‘ $07 Light Blue 15 $0F White 


As explained later in the section “Display Pages,” the text display and the 
low-resolution graphics display use the same area in memory. Most 
programs that generate text and graphics clear this part of memory when 
they change display modes, but it is possible to store data as text and 
display it as graphics, or vice-versa. All you have to do is change the mode 
switch, described later in this chapter in the section “Display Mode 
Switching,” without changing the display data. This usually produces 
meaningless jumbles on the display, but some programs have used this 
technique to good advantage for producing complex low-resolution graphics 
displays quickly. 


High-Resolution Graphics 


In the high-resolution graphics mode, the Apple Ile displays an array of 
colored dots in 192 rows and 280 columns. The colors available are black, 
white, purple, green, orange, and blue, although the colors of the individual 
dots are limited, as described later in this section. Adjacent dots of the same 
color merge to form a larger colored area. 


Data for the high-resolution graphics displays are stored in either of two 
8192-byte areas in memory. These areas are called high-resolution Page 1 
and Page 2; think of them as buffers where you can put data to be 
displayed. Normally, your programs will use the features of some high-level 
language to draw graphics dots, lines, and shapes to display; this section 
describes the way the resulting graphics data are stored in the Apple Ile’s 
memory. 
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Figure 2-4. High-Resolution Display 
Bits 


Bits in Data Byte 


Dots on Graphics Screen 


For more details about the way the 
Apple Ile produces color on a TV set, see 
the section “Video Display Modes” in 
Chapter 7. 
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The Apple Ile high-resolution graphics display is bit-mapped: each dot on 
the screen corresponds to a bit in the Apple IIe’s memory . The seven 
low-order bits of each display byte control a row of seven adjacent dots on 
the screen, and forty adjacent bytes in memory control a row of 280 

(7 times 40) dots. The least significant bit of each byte is displayed as the 
leftmost dot in a row of seven, followed by the second-least significant bit, 
and so on, as shown in Figure 2-4. The eighth bit (the most significant) of 
each byte is not displayed; it selects one of two color sets, as described later. 


On a black-and-white monitor, there is a simple correspondence between 
bits in memory and dots on the screen. A dot is white if the bit controlling it 
is on (1), and the dot is black if the bit is off (0). On a black-and-white 
television set, pairs of dots blur together; alternating black and white dots 
merge to a continuous grey. 


On an NTSC color monitor or a color television set, a dot whose controlling 
bit is off (0) is black. If the bit is on, the dot will be white or a color, 
depending on its position, the dots on either side, and the setting of the 
high-order bit of the byte. 


Call the left-most column of dots column zero, and assume (for the moment) 
that the high-order bits of all the data bytes are off (0). If the bits that 
control dots in even-numbered columns (0, 2, 4, and so forth) are on, the 
dots are purple; if the bits that control odd-numbered columns are on, the 
dots are green—but only if the dots on both sides of a given dot are black. If 
two adjacent dots are both on, they are both white. 


You select the other two colors, blue and orange, by turning the high-order 
bit (bit 7) of a data byte on (1). The colored dots controlled by a byte with 
the high-order bit on are either blue or orange: the dots in even-numbered 
columns are blue, and the dots in odd-numbered columns are orange— 
again, only if the dots on both sides are black. Within each horizontal line of 
seven dots controlled by a single byte, you can have black, white, and one 
pair of colors. To change the color of any dot to one of the other pair of 
colors, you must change the high-order bit of its byte, which affec ts the 
colors of all seven dots controlled by the byte. 


In other words, high-resolution graphics displayed on a color monitor or 
television set are made up of colored dots, according to the following rules: 


O Dots in even columns can be black, purple, or blue. 
O Dots in odd columns can be black, green, or orange. 
O If adjacent dots in a row are both on, they are both white. 


oO The colors in each row of seven dots controlled by a single byte are either 
purple and green, or blue and orange, depending on whether the 
high-order bit is off (O) or on (1). 
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For information about the way NTSC color 
television works, see the magazine articles 
listed in the bibliography. 


These rules are summarized in Table 2-7. The blacks and whites are 
numbered to remind you that the high-order bit is different. 


Table 2-7. High-Resolution Graphics Colors 


Note: Colors may vary depending upon the controls on the monitor or television 
set. 


Bits 0-6 Bit 7 Off Bit 7 On 
Adjacent columns off Black 1 Black 2 
Even columns on Purple Blue 
Odd columns on Green Orange 
Adjacent columns on White 1 White 2 


The peculiar behavior of the high-resolution colors reflects the way NTSC 
color television works. The dots that make up the Apple Ile video signal are 
spaced to coincide with the frequency of the color subcarrier used in the 
NTSC system. Alternating black and white dots at this spacing cause a 
color monitor or TV set to produce color, but two or more white dots 
together do not. 


Double-High-Resolution Graphics 


Double-high-resolution graphics is a bit-mapping of the low-order seven bits 
of the bytes in the main-memory and auxiliary-memory pages at 
$2000-$3FFF. The bytes in the main-memory and auxiliary-memory pages 
are interleaved in exactly the same manner as the characters in 80-column 
text: of each pair of identical addresses, the auxiliary-memory byte is 
displayed first, and the main-memory byte is displayed second. Horizontal 
resolution is 560 dots when displayed on a monochrome monitor. 


Unlike high-resolution color, double-high-resolution color has no restrictions 
on which colors can be adjacent. Color is determined by any four adjacent 
dots along a line. Think of a 4-dot-wide window moving across the screen: at 
any given time, the color displayed will correspond to the 4-bit value from 
Table 2-8 that corresponds to the window’s position (Figure 2-9). Effective 
horizontal resolution with color is 140 (560 divided by four) dots per line. 


To use Table 2-8, divide the display column number by 4, and use the 
remainder to find the correct column in the table: ab0 is a byte residing in 
auxiliary memory corresponding to a remainder of 0 (byte 0, 4, 8, and so on); 
mb! is a byte residing in main memory corresponding to a remainder of 1 
(byte 1,5, 9 and so on), and similarly for ab3 and mb4. 
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Table 2-8. Double-High-Resolution Graphics Colors 


Repeated 
Color ab0 mb1 ab2 mb3 Bit Pattern 
Black $00 $00 $00 $00 0000 
Magenta $08 $11 $22 $44 0001 
Brown $44 $08 $11 $22 0010 
Orange $4C $19 $33 $66 0011 
Dark Green $22 $44 $08 $11 0100 
Gray 1 $2A $55 $2A $55 0101 
Green $66 $4C $19 $33 0110 
Yellow $6E $5D $3B $77 0111 
Dark Blue $11 $22 $44 $08 1000 
Purple $19 $33 $66 $4C 1001 
Gray 2 $55 $2A $55 $2A 1010 
Pink $5D $3B $77 $6E 1011 
Medium Blue $33 $66 $4C $19 1100 
Light Blue $3B $77 $6E $5D 1101 
Aqua $77 $6E $5D $3B 1110 
White STF $7F $7F $7F 111 


Video Display Pages 
Se a es ae ae Te 


The Apple Ile generates its video displays using data stored in specific areas 
in memory. These areas, called display pages, serve as buffers where your 
programs can put data to be displayed. Each byte in a display buffer 
controls an object at a certain location on the display. In text mode, the 
object is a single character; in low-resolution graphics, the object is two 
stacked colored blocks; and in high-resolution and double-high-resolution 
modes, it is a line of seven adjacent dots. 
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The 40-column-text and low-resolution-graphics modes use two display 
pages of 1024 bytes each. These are called text Page 1 and text Page 2, and 
they are located at 1024-2047 (hexadecimal $0400-$07FF) and 2048-3071 
($0800-$0BFF) in main memory. Normally, only Page 1 is used, but you can 
put text or graphics data into Page 2 and switch displays instantly. Either 
page can be displayed as 40-column text, low-resolution graphics, or 
mixed-mode (four rows of text at the bottom of a graphics display). 


The 80-column text mode displays twice as much data as the 40-column 
mode—1920 bytes—but it cannot switch pages. The 80-column text display 
uses a combination page made up of text Page 1 in main memory plus 
another page in auxiliary memory located on the 80-column text card. This 
additional memory is vot the same as text Page 2—in fact, it occupies the 
same address space as text Page 1, and there is a special soft switch that 
enables you to store data into it. (See the next section “Display Mode 
Switching.” ) The built-in firmware I/O routines described in Chapter 3 take 
care of this extra addressing automatically; that is one reason to use those 
routines for all your normal text output. 


The high-resolution graphics mode also has two display pages, but each 
page is 8192 bytes long. In the 40-column text and low-resolution graphics 
modes each byte controls a display area seven dots wide by eight dots high. 
In high-resolution graphics mode each byte controls an area seven dots wide 
by one dot high. Thus, a high-resolution display requires eight times as 
much data storage, as shown in Table 2-9. 


The double-high-resolution graphics mode uses high-resolution Page 1 in 
both main and auxiliary memory. Each byte in those pages of memory 
controls a display area seven dots wide by one dot high. This gives you 560 
dots per line in black and white, and 140 dots per line in color. A 
double-high-resolution display requires twice the total memory as 
high-resolution graphics, and 16 times as much as a low-resolution display. 
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Table 2-9. Video Display Page Locations 


Display Lowest Address Highest Address 
Display Mode Page Hex Dec Hex Dec 
40-column text, 1 $0400 1024 $O7FF 2047 
low-resolution graphics 2* $0800 2048 $OBFF 8071 
80-column text 1 $0400 1024 $O7FF =. 2047 

a" $0800 2048 $OBFF 3071 
High-resolution 1 $2000 8192 $3FFF 16388 
graphics 2 $4000 16384 $5FFF 24575 
Double-high- lt $2000 8192 $3FFF 16888 
resolution graphics 21 $4000 16384 $5FFF 24575 


* This is not supported by firmware; for instructions on how to switch pages, re fer to the 
next section “Display Mode Switching.” 


t See the section “Double-High-Resolution Graphics,” earlier in this chapter. 


Display Mode Switching 
a gr i a ea ee | 


You select the display mode that is appropriate for your application by 
reading or writing to a reserved memory location called a soft switch. In the 
Apple Ile, most soft switches have three memory locations reserved for 
them: one for turning the switch on, one for turning it off, and one for 
reading the current state of the switch. 


Table 2-10 shows the reserved locations for the soft switches that control 
the display modes. For example, to switch from mixed-mode to full-screen 
graphics in an assembly-language program, you could use the instruction 


STA $C852 
To do this in a BASIC program, you could use the instruction 
POKE 49234,0 


Some of the soft switches in Table 2-10 must be read, some must be written 
to, and for some you can use either action. When writing to a soft switch, it 
doesn’t matter what value you write; the action occurs when you address 
the location, and the value is ignored. 
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Table 2-10. Display Soft Switches 


Note: W means write anything to the location, R means read the location, R/W 
means read or write, and R7 means read the location and then check bit 7. 


Name 


ALTCHAR 
ALTCHAR 


RDALTCHAR 


80COL 
80COL 
RD80COL 


80STORE 
80STORE 


RD80STORE 


PAGE2 
PAGE2 


RDPAGE2 


TEXT 
TEXT 
RDTEXT 


MIXED 
MIXED 
RDMIXED 


HIRES 
HIRES 


RDHIRES 
IOUDIS 


IOUDIS 


RDIOUDIS 


DHIRES 
DHIRES 
RDDHIRES 


Action Hex 


W 
W 
R7 


R7 


R/W 
R/W 
R7 


$COOE 
$COOF 
SCO1E 


$C00C 
$C00D 
SCOIF 


$0000 
$C001 
$0018 


30054 
$0055 


$C01C 


$C050 
$0051 
SCO1A 


$C052 
$0053 
$CO1B 


$C056 
$C057 


$C01D 
$CO7E 


$CO7F 


$CO7E 


$CO5E 
$CO5F 
$CO7F 


Function 


Off: display text using primary character set 
On: display text using alternate character set 
Read ALTCHAR switch (1 = on) 


Off: display 40 columns 
On: display 80 columns 
Read 80COL switch (1 = on) 


Off: cause PAGEZ2 on to select auxiliary RAM 
On: allow PAGE2 to switch main RAM areas 
Read 80STORE switch (1 = on) 


Off: select Page 1 

On: select Page 2 or, if 80STORE on, Page 1 in 
auxiliary memory 

Read PAGE2 switch (1 = on) 


Off: display graphics or, if MIXED on, mixed 
On: display text 
Read TEXT switch (1 = on) 


Off: display only text or only graphics 
On: if TEXT off, display text and graphics 
Read MIXED switch (1 = on) 


Off: if TEXT off, display low-resolution graphics 
On: if TEXT off, display high-resolution or, if 
DHIRES on, double-high-resolution graphics 
Read HIRES switch (1 = on) 


On: disable IOU access for addresses $C058 to 
$CO5F; enable access to DHIRES switch * 

Off: enable IOU access for addresses $C058 to 
$CO5F; disable access to DHIRES switch * 
Read IOUDIS switch (1 = off) t 


On: if IOUDIS on, turn on double-high-res. 
Off: if IOUDIS on, turn off double-high-res. 
Read DHIRES switch (1 = on) t 


*The firmware normally leaves IOUDIS on. See also f. 


+ Reading or writing any address in the range $C070-$C07F also triggers the paddle timer 
and resets VBLINT (Chapter 7). 
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For a full description of the way the 

Apple Ile handles its display memory, refer 
to the section “Display Memory 
Addressing” in Chapter 7. 
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By the Way: You may not need to deal with these functions by reading 
and writing directly to the memory locations in Table 2-10. Many of the 
functions shown here are selected automatically if you use the display 
routines in the various high-level languages on the Apple Ile. 


Any time you read a soft switch, you get a byte of data. However, the only 
information the byte contains is the state of the switch, and this occupies 
only one bit—bit 7, the high-order bit. The other bits in the byte are 
unpredictable. If you are programming in machine language, the switch 
setting is the sign bit; as soon as you read the byte, you can do a Branch 
Plus if the switch 1s off, or Branch Minus if the switch if on. 


If you read a soft switch from a BASIC program, you get a value between 0) 
and 255. Bit 7 has a value of 128, so if the switch is on, the value will be 
equal to or greater than 128; if the switch is off, the value will be Less 

than 128. 


Addressing Display Pages Directly 
=a ee ee ee eee 


Before you decide to use the display pages directly, consider the 
alternatives. Most high-level languages enable you to write statements that 
control the text and graphics displays. Similarly, if you are programming in 
assembly language, you may be able to use the display features of the 
built-in 1/O firmware. You should store directly into display memory only if 
the existing programs can’t meet your requirements. 


The display memory maps are shown in Figures 2-5, 2-6, 2-7, 2-8, and 2-9. 
All of the different display modes use the same basic addressing s cheme: 
characters or graphics bytes are stored as rows of 40 contiguous bytes, but 
the rows themselves are not stored at locations corresponding to their 
locations on the display. Instead, the display address is transformed so that 
three rows that are eight rows apart on the display are grouped together and 
stored in the first 120 locations of each block of 128 bytes ($80 
hexadecimal). By folding the display data into memory this way, the 

Apple Ile, like the Apple II, stores all 960 characters of displayed text within 
1K bytes of memory. 
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For more details about the way the displays 
are generated, see Chapter 7. 


The high-resolution graphics display is stored in much the same way as 
text, but there are eight times as many bytes to store, because eight rows of 
dots occupy the same space on the display as one row of characters. The 
subset consisting of all the first rows from the groups of eight is stored in 
the first 1024 bytes of the high-resolution display page. The subset 
consisting of all the second rows from the groups of eight is stored in the 
second 1024 bytes, and so on for a total of 8 times 1024, or 8192 bytes. In 
other words, each block of 1024 bytes in the high-resolution display page 
contains one row of dots out of every group of eight rows. The individual 
rows are stored in sets of three 40-byte rows, the same way as the text 
display. 


All of the display modes except 80-column mode and double-high-resolution 
graphics mode can use either of two display pages. The display maps show 
addresses for each mode’s Page 1 only. To obtain addresses for text or 
low-resolution graphics Page 2, add 1024 ($400); to obtain addresses for 
high-resolution Page 2, add 8192 ($2000). 


The 80-column display and double-high-resolution graphics mode work a 
little differently. Half of the data is stored in the normal text Page-1 
memory, and the other half is stored in memory on the 80-column text card 
using the same addresses. The display circuitry fetches bytes from these 
two memory areas simultaneously and displays them sequentially: first the 
byte from the 80-column text card memory, then the byte from the main 
memory. The main memory stores the characters in the odd columns of the 
display, and the 80-column text card memory stores the characters in the 
even columns. 


To store display data on the 80-column text card, first turn on the 80STORE 
soft switch by writing to location 49153 (hexadecimal $C001 or 
complementary -16383). With 80STORE on, the page-select switch, PAGE2, 
selects between the portion of the 80-column display stored in Page 1 of 
main memory and the portion stored in the 80-column text card memory. To 
select the 80-column text card, turn the PAGE2 soft switch on by reading or 
writing at location 49287. 
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Figure 2-5. Map of 40-Column Text Display 
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Figure 2-6. Map of 80-Column Text Display 
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Figure 2-7. Map of Low-Resolution Graphics Display 
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Figure 2-8. Map of High-Resolution Graphics Display 


Row 


BOMmNSM Nemo ntMNooahhs a0 
co => 
on) 


$2000 8192 FOOTE TEE 
soo sl TTT TTTLILLiLert LeeLee FF FALE LLL 
si sus | |TTLILiLi titer 
soiso sve | 111111111 EE LLL LEE 
soo smal | TTT TTT TTT Ti cee FT 
soso wel | TTT TTT Tritt fei LET LL 
sao sol | TITTITIfTiiiittLLeL Litt Lee ALLL 
sso ost | TTT TIT P Prt i A 
sos 2 | [TTT ATLL 
soas 301 | ( {TTI TITTLE LT EE 
sae owe [TTT TTT TTT TTT RO 
S21A8 8616 SROSRRRRORERREEE) oT SOGRRRERRREE 
$2228 8744 

sons s72(| 111111 PPP [l(t TITTTT tT + 0 +80000 


ees oo TT) Ft 

sons et LLELELLELLELLL LN ale 

sco wre TT, | PY et 

seono seoo | LELELELELLLELLLLL A 

$2150 85281 | | | | |i ty t yd ddd tid tl [LILILLIT I +3072 +$0C00 

servo sess TTT TLPPLLLP LEE 

somo ml TILTLILI LLL LLL) CTT LT IL [J +10 +8100 

eno we TET) a st 

sesso sot LLELELLELLELELLELL LA 

wooo oes TET 7d oa +80 
CTT TTT) +2 00 


Sanereerw2oastaoees 
S So © SS S&S] @ @) 


The Video Display Generator 30 


Figure 2-9. Map of Double-High-Resolution Graphics Display 
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Secondary Inputs and Outputs 


Important! 


Electrical specifications of the speaker 
circuit appear in Chapter 7. 


In addition to the primary I/O devices—the keyboard and display—there 
are several secondary input and output devices in the Apple Ile. These 
devices are 


Oo the speaker (output) 
O cassette input and output 

O annunciator outputs 

O strobe output 

O switch inputs 

O analog (hand control) inputs. 


These devices are similar in operation to the soft switches described in the 
previous section: you control them by reading or writing to dedicated 
memory locations. Action takes place any time your program reads or 
writes to one of these locations; information written is ignored. 


Some of these devices toggle—change state—each time they are 
accessed. If you write using an indexed store operation, the Apple IIe’s 
microprocessor activates the address bus twice during successive clock 
cycles, causing a device that toggles each time it is addressed to end up 
back in its original state. For this reason, you should read, rather than 
write, to such devices. 


The Speaker 


The Apple Ile has a small speaker mounted toward the front of the bottom 
plate. The speaker is connected to a soft switch that toggles; it has two 
states, off and on, and it changes from one to the other each time it is 
accessed. (At low frequencies, less than 400 Hz or so, the speaker clicks 
only on every other access. ) 


If you switch the speaker once, it emits a click; to make longer sounds, you 
access the speaker repeatedly. You should always use a read operation to 
toggle the speaker. If you write to this soft switch, it switches twice in rapid 
succession. The resulting pulse is so short that the speaker doesn’t have 
time to respond; it doesn’t make a sound. 
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BELLI is described in Appendix B. 


Detailed electrical specifications for the 
cassette input and output are given in 
Chapter 7. 


WRITE is described in Appendix B. 
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The soft switch for the speaker uses memory location 49200 (hexadecimal 
$C030). From Integer BASIC, use the complementary address -16386. You 
can make various tones and buzzes with the speaker by using co mbinations 
of timing loops in your program. There is also a routine in the built-in 
irmware to make a beep through the speaker. This routine is called BELLI. 


Cassette Input and Output 


hate Re enIN Se Ne al Ese ad ee ee ea ers 

There are two miniature phone jacks on the back panel of the Apple Ile. You 
can use a pair of standard cables with miniature phone plugs to connect an 
ordinary cassette tape recorder to the Apple Ile and save programs and data 
on audio cassettes. 


The phone jack marked with a picture of an arrow pointing towards a 
cassette is the output jack. It is connected to a toggled soft switch, like the 
speaker switch described above. The signal at the phone jack switches from 
zero to 25 millivolts or from 25 millivolts to zero each time you access the 
soft switch. 


If you connect a cable from this jack to the microphone input of a cassette 
tape recorder and switch the recorder to record mode, the signal changes 
you produce by accessing this soft switch will be recorded on the tape. The 
cassette output switch uses memory location 49184 (hexadecima. $C020; 
complementary value -16352). Like the speaker, this output will toggle 
twice if you write to it, so you should only use read operations to control the 
cassette output. 


The standard method for writing computer data on audio tapes uses tones 
with two different pitches to represent the binary states zero andl one. To 
store data, you convert the data into a stream of bits and convert the bits 
into the appropriate tones. To save you the trouble of actually programming 
the tones, and to ensure consistency among all Apple II cassette tapes, there 
is a built-in routine called WRITE for producing cassette data out put. 
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READ is described in Appendix B. 


Complete electrical specifications of these 
inputs and outputs are given in Chapter 7. 


The phone jack marked with a picture of an arrow coming from a cassette is 
the input jack. It accepts a cable from the cassette recorder’s earphone jack. 
The signal from the cassette is 1 volt (peak-to-peak) audio. Each time the 
instantaneous value of this audio signal changes from positive to negative, 
or vice-versa, the state of the cassette input circuit changes from zero to one 
or vice-versa. You can read the state of this circuit at memory location 
49248 (hexadecimal $C060, or complementary decimal -16288). 


When you read this location, you get a byte, but only the high-order bit 

(bit 7) is valid. If you are programming in machine language, this is the sign 
bit, so you can perform a Branch Plus or Branch Minus immediately after 
reading this byte. BASIC is too slow to keep up with the audio tones used for 
data recording on tape, but you don’t need to write the program: there is a 
built-in routine called READ for reading data from a cassette. 


The Hand Control Connector Signals 


i ee ee 

Several inputs and outputs are available on a 9-pin D-type miniature 
connector on the back of the Apple Ile: three one-bit inputs, or switches, 
and four analog inputs. These signals are also available on the 16-pin IC 
connector on the main circuit board, along with four one-bit outputs and a 
data strobe. You can access all of these signals from your programs. 


Ordinarily, you connect a pair of hand controls to the 9-pin connector. The 
rotary controls use two analog inputs, and the push-buttons use two one-bit 
inputs. However, you can also use these inputs and outputs for many other 
jobs. For example, two analog inputs can be used with a two-axis joystick. 
Table 7-19 shows the connector pin numbers. 
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For electrical specifications of the 
annunciator outputs, refer to Chapter 7. 
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Annunciator Outputs 


The four one-bit outputs are called annunciators. Each annunciator can be 
used to turn a lamp, a relay, or some similar electronic device on and off. 


Each annunciator is controlled by a soft switch, and each switch uses a pair 
of memory locations. These memory locations are shown in Table 2-11. 
Any reference to the first location of a pair turns the corresponding 
annunciator off; a reference to the second location turns the annunciator 
on. There is no way to read the state of an annunciator. 


Table 2-11. Annunciator Memory Locations 


Annunciator Address 

No. Pin* State Decimal Hex 

0 15 off 49240 -16296 $0058 
on 49241 -16295 $0059 

] 14 off 49242 -16294 $CO5A 
on 49243 -16298 $CO5B 

2 13 off 492.44 -16292 $C05C 
on 49245 -16291 $C05D 

3 12 off 49246 -16290 $C05E 
on 49247 -16289 SCO5F 


* Pin numbers given are for the 16-pin IC connector on the circuit board. 


Strobe Output 


The strobe output is normally at +5 volts, but it drops to zero for about half 
a microsecond any time its dedicated memory location is accesse d. You can 
use this signal to control functions such as data latching in extermal devices. 
If you use this signal, remember that memory is addressed twice by a write; 
if you need only a single pulse, use a read operation to activate the strobe. 
The memory location for the strobe signal is 49216 (hexadecimal $C040 or 
complementary -16320). 
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Switch Inputs 


The three one-bit inputs can be connected to the output of another 
electronic device or to a pushbutton. When you read a byte from one of 
these locations, only the high-order bit—bit 7—is valid information; the rest 
of the byte is undefined. From machine language, you can do a Branch Plus 
or Branch Minus on the state of bit 7. From BASIC, you read the switch with 
a PERK and compare the value with 128. If the value is 128 or greater, the 
switch is on. 


The memory locations for these switches are 49249 through 49251 
(hexadecimal $C061 through $C063, or complementary -16287 through 
-16285), as shown in Table 2-12. Switch 0 and switch 1 are permanently 
connected to the (G]and (#] keys on the keyboard; these are the ones 
normally connected to the buttons on the hand controls. Some software for 
the older models of the Apple II uses the third switch, switch 2, as a way of 
detecting the shift key. This technique requires a hardware modification 
known as the single-wire shift-key mod. 


You should be sure that you really need the shift-key mod before you go 
ahead and do it. It probably is not worth it unless you have a program that 
requires the shift-key mod that you cannot either replace or modify to work 
without it. 


If you make the shift-key modification and connect a joystick or other 
hand control that uses switch 2, you must be careful never to close the 
switch and press at the same time: doing so produces a short 
circuit that causes the power supply to turn off. When this happens, any 
programs or data in the computer's internal memory are lost. 


Shift-Key Mod: To perform this modification on your Apple Ile, all you 
have to do is solder across the broken diamond labelled X6 on the main 
circuit board. Remember to turn off the power before changing anything 
inside the Apple Ile. Also remember that changes such as this are at your 
own risk and may void your warranty. 
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Refer to the section “Game I/O Signals” in 
Chapter 7 for details. 


PREAD is described in Appendix B. 
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Analog Inputs 


The four analog inputs are designed for use with 150K ohm variable 
resistors or potentiometers. The variable resistance is connected between 
the +5V supply and each input, so that it makes up part of a timing circuit. 
The circuit changes state when its time constant has elapsed, and the time 
constant varies as the resistance varies. Your program can measure this 
time by counting in a loop until the circuit changes state, or times out. 


Before a program can read the analog inputs, it must first reset the timing 
circuits. Accessing memory location 49264 (hexadecimal $C070 or 
complementary -16272) does this. As soon as you reset the timing circuits, 
the high bits of the bytes at locations 49252 through 49255 (hexadecimal 
$C064 through $C067 or complementary -16284 through -16281) are set to 1. 
If you PEEK at them from BASIC, the values will be 128 or greater. Within 
about 3 milliseconds, these bits will change back to 0—byte values less 
than 128—and remain there until you reset the timing circuits again. The 
exact time each of the four bits remains high is directly proportional to the 
resistance connected to the corresponding input. If these inputs are open— 
no resistances are connected—the corresponding bits may remain high 
indefinitely. 


To read the analog inputs from machine language, you can use a program 
loop that resets the timers and then increments a counter until the bit at the 
appropriate memory location changes to 0, or you can use the built-in 
routine called PREAD. High-level languages, such as BASIC, also include 
convenient means of reading the analog inputs: refer to your language 
manuals. 


Summary of Secondary I/O Locations 
—— 


Table 2-12 shows the memory locations for all of the built-in I/O devices 
except the keyboard and display. As explained earlier, some soft s-witches 
should only be accessed by means of read operations; those switches are 
marked. 
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Table 2-12. Secondary I/O Memory Locations 


For connector identification and pin numbers, refer to Tables 7-18 and 7-19. 


Function 
Speaker 


Cassette out 
Cassette in 


Annunciator 0 on 
Annunciator 0 off 


Annunciator | on 
Annunciator | off 


Annunciator 2 on 
Annunciator 2 off 


Annunciator 3 on 
Annunciator 3 off 


Strobe output 


Switch input 0 (()) 
Switch input 1 ((#)]) 
Switch input 2 


Analog input reset 


Analog input 0 
Analog input 1 
Analog input 2 
Analog input 3 


Secondary Inputs and Outputs 


Address 
Decimal 
49200 -16336 
49184 -16352 
49248 -16288 
49241 -16295 
49240 -16296 
49243 -16298 
49242 -16294 
492.45 -16291 
492.44 -16292 
49247 -16289 
49246 -16290 
49216 -163820 
49249 -16287 
49250 -16286 
49251 -16285 
49264 -16272 
49252 -16284 
49253 -16283 
49254 -16282 
49255 -16281 


Hex 
$C030 


$0020 
$0060 


$0059 
$0058 


$C05B 
$CO5A 


$C05D 
$C05C 


SCO5F 
$CO5E 


$C040 


$0061 
$0062 
$0063 


$0070 


$0064 
$0065 
$0066 
$C067 


Access 
Read only 


Read only 
Read only 


Read only 


Read only 
Read only 
Read only 


Read only 
Read only 
Read only 
Read only 
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The Monitor, or System Monitor, is a 
computer program that is used to operate 
the computer at the machine language 
level. 


Important! 
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Almost every program on the Apple Ile takes input from the keyboard and 
sends output to the display. The Monitor and the Applesoft and Integer 
BASICs do this by means of standard 1/0 subroutines that are built into the 
Apple Ile’s firmware. Many application programs also use the standard 1/0 
subroutines, but Pascal programs do not; Pascal has its own I/O 
subroutines. 


This chapter describes the features of these subroutines as they are used by 
the Monitor and by the BASIC interpreters, and tells you how to use the 
standard subroutines in your assembly-language programs. 


High-level languages already include convenient methods for handling 
most of the functions described in this chapter. You should not need to 
use the standard 1/0 subroutines in your programs unless you are 
programming in assembly language. 


Table 3-1. Monitor Firmware Routines 


Location 


$C305 


$C307 


SFC9C 
SFC9E 


$FC42 
$F832 
$F836 
SFDED 


$FDFO 
SFD8E 
$FD8B 


SFD6A 


$F819 
$FC58 


Name 


BASICIN 


PASICOUT 


CLREOL 
CLEOLZ 


CLREOP 
CLRSCR 
CLRTOP 
COUT 


COUT 
CROUT 
CROUT1 


GETLN 


HLINE 
HOME 


Description 


With 80-column dirmware active, displays solid, 
blinking cursor. Accepts character from keyboard. 


Displays a character on the screen; used w hen the 
80-column firmware is active (Chapter 8). 


Clears to end of line from current cursor position. 


Clears to end of line using contents of Y register as 
cursor position. 


Clears to bottom of window. 
Clears the low-resolution screen. 
Clears top 40 lines of low-resolution screen. 


Calls output routine whose address is stored in CSW 
(normally COUT], Chapter 3). 


Displays a character on the screen (Chapter 3). 
Generates a carriage return character. 


Clears to end of line, then generates a carrkage return 
character. 


Displays the prompt character; accepts a string of 
characters by means of RDKEY. 


Draws a horizontal line of blocks. 


Clears the window and puts cursor in uppe r-left 
corner of window. 
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AUXMOVE and XFER are described in the 
section “Auxiliary-Me mory Subroutines” in 


Chapter 4. 


Table 3-1—Continued. Monitor Firmware Routines 


Location Name Description 

$FDIB KEYIN With 80-column firmware inactive, displays 
checkerboard cursor. Accepts character from 
keyboard. 

$F 800 PLOT Plots a single low-resolution block on the screen. 

$FO4A PRBL2 Sends | to 256 blank spaces to the output device. 

$FDDA PRBYTE Prints a hexadecimal byte. 

$FF2D PRERR Sends Err and Control-G to the output device. 

$FDE3 PRHEX Prints 4 bits as a hexadecimal number. 

$F941 PRNTAX Prints contents of A and X in hexadecimal. 

$FDOC RDKEY Displays blinking cursor; goes to standard input 
routine, normally KEYIN or BASICIN. 

$F87 1 SCRN Reads color value of a low-resolution block. 

$F 864 SETCOL Sets the color for plotting in low-resolution. 

$FC24 VTABZ Sets cursor vertical position. 

$F828 VLINE Draws a vertical line of low-resolution blocks. 


The standard I/O subroutines listed in Table 8-1 are fully described in this 
chapter. The Apple Ile firmware also contains many other subroutines that 
you might find useful. Those subroutines are described in Appendix B. Two 
of the built-in subroutines, AUXMOVE and XFER, can help you use the 
optional auxiliary memory. 


Using the I/O Subroutines 


a fk 


Before you use the standard I/O subroutines, you should understand a little 
about the way they are used. The Apple Ile firmware operates differently 
when an option such as an 80-column text card is used. This section 
describes general situations that affect the operation of the standard I/O 
subroutines. Specific instances are described in the sections devoted to the 
individual subroutines. 
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Apple |i Compatibility 
sie ese nani einnoes ee aan 


Compared to older Apple II models, the Apple IIe has some additional 
keyboard and display features. To run programs that were written for the 
older models, you can make the Apple Ile resemble an Apple II Plus by 
turning those features off. The features that you can turn off and on to put 
the Apple Ile into and out of Apple II mode are listed in Table 3-2. 


Table 3-2. Apple II Mode 


Apple Ile Apple II Mode 
Keyboard Uppercase and lowercase Uppercase only 
Display characters Inverse and normal only Flashing, inverse, and 
normal 
Display size 40-column; also 80-column 40-column only 
with optional card 


If the Apple Ile does not have an 80-column text card installed in the 
auxiliary slot, it is almost in Apple II mode as soon as you turn it on or reset 
it. One exception is the keyboard, which is both uppercase and lowercase. 


Original lle On an original Apple Ile, DOS 3.3 commands and statements in Integer 
BASIC and Applesoft must be typed in uppercase letters. To be 
compatible with older software, you should switch the Apple Ile keyboard 
to uppercase by pressing [CAPS LOCK]. 


Another feature that is different on the Apple Ile as compared to the 

Apple II is the displayed character set. An Apple II displays only uppercase 

characters, but it displays them three ways: normal, inverse, and flashing. 

The Apple Ile can display uppercase characters all three ways, and it can 

display lowercase characters in the normal way. This combination is called 
The primary and alternate character sets the pramary character set. When the Apple Ile is first turned on or reset, 


are described in Chapter 2 in the section it displays the primary character set. 
“Text Character Sets.” 


The Apple Ile has another character set, called the alternate character 
set, that displays a full set of normal and inverse characters, with. the 
inverse uppercase characters between $40 and $5F replaced on enhanced 
Apple IIe’s with MouseT ext characters. 


Original lle In the original Apple Ile, uppercase inverse characters appear in place of 
the MouseText characters of the enhanced Apple IIe and the Apple IIc. 


The ALTCHAR soft switch is describedin You can switch character sets at any time by means of the ALTCHAR soft 
Chapter 2. switch. 
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See the section “Switching I/O Memory” in 
Chapter 6 for details. 


Important! 


SLOTC8ROM is described in Chapter 6 in 
the section “Switching 1/0 Memory.” 


For more information about interrupts, see 
Chapter 6. 


The 80-Column Firmware 


There are a few features that are normally available only with the optional 
80-column display. These features are identified in Table 3-3b and 

Table 3-6. The firmware that supports these features is built into the 

Apple Ile, but it is normally active only if an 80-column text card is installed 
in the auxiliary slot. 


When you turn on power or reset the Apple Ile, the 80-column firmware is 
inactive and the Apple Ile displays the primary character set, even if an 
80-column text card is installed. When you activate the 80-column 
firmware, it switches to the alternate character set. 


The built-in 80-column firmware is implemented as if it were installed in 
expansion slot 3. Programs written for an Apple II or Apple II Plus with an 
80-column text card installed in slot 3 usually will run properly on a 
Apple Ie with an 80-column text card in the auxiliary slot. 


If the Apple Ile has an 80-column text card and you want to use the 
80-column display, you can activate the built-in firmware from BASIC by 
typing 

PR#3 


To activate the 80-column firmware from the Monitor, press [3], then 
(CONTROL }{P}. Notice that this is the same procedure you use to activate a 
card in expansion slot 8. Any card installed in the auxiliary slot takes 
precedence over a card installed in expansion slot 3: 


Even though you activated the 80-column firmware by typing PR#3, you 
should never deactivate it by typing PR#0, because that just disconnects 
the firmware, leaving several soft switches still set for 80-column 


operation. Instead, type the sequence [CONTROL }{Q]. (See 
Table 3-6. ) 


If there is no 80-column text card or other auxiliary memory card in your 
Apple Ile, you can still activate the 80-column firmware and use it with a 
40-column display. First, set the SLOTC3ROM soft switch located at $CO0A 
(49162). Then type PR#8 to transfer control to the firmware. 


When the 80-column firmware is active without a card in the auxiliary slot, 
it does not work quite the same as it does with a card. The functions that 
clear the display (CLREOL, CLEOLZ, CLREOP, and HOME) work as if the 
firmware were inactive: they always clear to the current color. Also, 
interrupts are supported only with a card installed in the auxiliary slot. 
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If you do not have an interface card in either the auxiliary slot or slot 3, 
don’t try to activate the firmware with PR#8. Typing PR#8 with no card 
installed transfers control to the empty connector, with unpredictable 
results. 


Programs activate the 80-column firmware by transferring control to 
address $C300. If there is no card in the auxiliary slot, you must set the 
SLOTC8ROM soft switch first. To deactivate the 80-column firmware from a 
program, write a Control-U character via subroutine COUT. 


The Old Monitor 


Apple II’s and Apple II Pluses used a version of the System Monitor 
different from the one the Apple Ile uses. It had the same standard I/O 
subroutines, but a few of the features were different; for example, there 
were no arrow keys for cursor motion. If you start the Apple IIe with a DOS 
or BASIC disk that loads Integer BASIC into the bank-switched area in 
RAM, the old Monitor (sometimes called the Autostart Monitor) is also 
loaded with it. When you type INT from Applesoft to activate Integer 
BASIC, you also activate this copy of the old Monitor, which remains active 
until you either type FP to switch back to Applesoft, which uses the new 
Monitor in ROM, or type 


PR#3 


to activate the 80-column firmware. Part of the firmware’s initialization 
procedure checks to see which version of the Monitor is in RAM. If it finds 
the old Monitor, it replaces it with a copy of the new Monitor from ROM. 
After the firmware has copied the new Monitor into RAM, it remains there 
until the next time you start up the system. 


The Standard |/O Links 


When you call one of the character I/O subroutines (COUT and RDKEY), 
the first thing that happens is an indirect jump to an address stored in 
programmable memory. Memory locations used for transferring control to 
other subroutines are sometimes called vectors; in this manual, the 
locations used for transferring control to the I/O subroutines are called I/O 
links. In a Apple Ile running without a disk operating system, each I/O link 
is normally the address of the body of the subroutine (COUT1 or KEYIN). If 
a disk operating system is running, one or both of these links hold the 
addresses of the corresponding DOS or ProDOS I/0 routines instead. (DOS 
and ProDOS maintain their own links to the standard I/O subroutines. ) 
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For more information about the I/O links, 
see the section “Changing the Standard 1/0 
Links” in Chapter 6. 


By calling the I/O subroutines that jump to the link addresses instead of 
calling the standard subroutines directly, you ensure that your program will 
work properly in conjunction with other software, such as DOS or a printer 
driver, that changes one or both of the I/O links. 


For the purposes of this chapter, we shall assume that the I/O links contain 
the addresses of the standard I/O subroutines—COUT1 and KEYIN if the 
80-column firmware is off, and BASICOUT and BASICIN if it is on. 


Standard Output Features 


en ee 


The standard output routine is named COUT, pronounced C-out, which 
stands for character out. COUT normally calls COUT1, which sends one 
character to the display, advances the cursor position, and scrolls the 
display when necessary. COUT] restricts its use of the display to an active 
area called the text window, described below. 


COUT Output Subroutine 
eee ee eee 


Your program makes a subroutine call to COUT at memory location $FDED 
with a character in the accumulator. COUT then passes control via the 
output link CSW to the current output subroutine, normally COUT1 (or 
BASICOUT), which takes the character in the accumulator and writes it 
out. If the accumulator contains an uppercase or lowercase letter, a number, 
or a special character, COUT! displays it; if the accumulator contains a 
control character, COUT] either performs one of the special functions 
described below or ignores the character. 


Each time you send a character to COUT1, it displays the character at the 
current cursor position, replacing whatever was there, and then advances 
the cursor position one space to the right. If the cursor position is already at 
the right-hand edge of the window, COUT1 moves it to the left-most position 
on the next line down. If this would move the cursor position past the end of 
the last line in the window, COUT] scrolls the display up one line and sets 
the cursor position at the left end of the new bottom line. 


The cursor position is controlled by the values in memory locations 36 and 
37 (hexadecimal $24 and $25). These locations are named CH, for cursor 
horizontal, and CV, for cursor vertical. COUT! does not display a cursor, but 
the input routines described below do, and they use this cursor position. If 
some other routine displays a cursor, it will not necessarily put it in the 
cursor position used by COUT]. 


Standard Output Features bl 


OZ 


Control Characters With COUT1 and BASICOUT 


COUT1 and BASICOUT do not display control characters. Instead, the 
control characters listed in Tables 3-3a and 3-3b are used to initiate some 
action by the firmware. Other control characters are ignored. Most of the 
functions listed here can also be invoked from the keyboard, either by 
typing the control character listed or by using the appropriate escape code, 
as described in the section “Escape Codes With KEYIN” later in this 
chapter. The stop-list function, described separately, can only be invoked 
from the keyboard. 


Table 3-3a. Control Characters With 80-Column Firmware Off 


Control ASCII Apple Ile 

Character Name Name Action Taken by COUT1 

Control-G BEL bell Produces a 1000 Hz tone for 0.1 second. 

Control-H BS backspace Moves cursor position one space to the 
left; from left edge of window, moves to 
right end of line above. 

Control-J LF line feed Moves cursor position down to next line in 
window; scrolls if needed. 

Control-M CR return Moves cursor position to left end of next 


line in window; scrolls if needed. 


Table 3-3b. Control Characters With 80-Column Firmware On 


Control ASCII Apple IIe 

Character Name Name Action Taken by BASICOUT 

Control-G BEL _ bell Produces a 1000 Hz tone for 0.1 second. 

Control-H BS backspace Moves cursor position one space to the 
left; from left edge of window, moves to 
right end of line above. 

Control-J LF line feed Moves cursor position down to next line in 
window; scrolls if needed. 

Control-KT VT clear EOS — Clears from cursor position to the end of 
the screen. 

Control-LT FF home Moves cursor position to upper -left corner 


and clear of window and clears window. 
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Table 3-3b—Continued. Control Characters With 80-Column Firmware On 


Control 
Character 
Control-M 


Control-Nt 
Control-Ot 
Control-Qt 
Control-Rt 
Control-S* 


Control-U ¢ 
Control-V fT 


Control-W tf 


Control-X 


Control-Y tf 


Control-Z t 
Control-[ 


Control-\t 


Control-]t 


Control-_ 


ASCII 
Name 


CR 


SO 
SI 
DCl 
DC2 
DC3 


NAK 
SYN 


ETB 


CAN 


EM 


SUB 
KSC 


US 


Apple IIe 
Name 


return 


normal 
inverse 
40-column 
80-column 


stop-list 


quit 


scroll 


scroll-up 


disable 
MouseText 


home 


clear line 


enable 
MouseText 


forward 
space 


clear EOL 


up 


* Only works from the keyboard. 


+ Doesn’t work from the keyboard. 
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Action Taken by BASICOUT 


Moves cursor position to left end of next 
line in window; scrolls if needed. 


Sets display format normal. 
Sets display format inverse. 
Sets display to 40-column. 
Sets display to 80-column. 


Stops listing characters on the display 
until another key is pressed. 


Deactivates 80-column video firmware. 


Scrolls the display down one line, leaving 
the cursor in the current position. 


Scrolls the display up one line, leaving the 
cursor in the current position. 


Disable MouseText character display; use 
inverse uppercase. 


Moves cursor position to upper-left corner 
of window (but doesn’t clear). 


Clears the line the cursor position is on. 


Map inverse uppercase characters to 
MouseText characters. 


Moves cursor position one space to the 
right; from right edge of window, moves it 
to left end of line below. 


Clears from the current cursor position to 
the end of the line (that is, to the right 
edge of the window). 


Moves cursor up a line, no scroll. 


00 


o4 
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The Stop-List Feature 
SSS SSS SSS el 


When you are using any program that displays text via COUT1 (or 
BASICOUT), you can make it stop updating the display by holding down 
and pressing (s ]. Whenever COUT] gets a carriage return from 
the program, it checks to see if you have pressed [CONTROL H S$}. If you 
have, COUT 1 stops and waits for you to press another key. When you want 
COUT! to resume, press another key; COUT1 will send the carriage return it 
got earlier to the display, then continue normally. The character code of the 
key you pressed to resume displaying is ignored unless you pressed 
(CONTROL }{C ]. COUT] passes Control-C back to the program; if it is a 
BASIC program, this enables you to terminate the program while in stop-list 
mode. 


The Text Window 


ESS Sea 

After starting up the computer or after a reset, the firmware uses the entire 
display. However, you can restrict video activity to any rectangular portion 
of the display you wish. The active portion of the display is called. the 

text window. COUT1 or BASICOUT puts characters into the window only; 
when it reaches the end of the last line in the window, it scrolls only the 
contents of the window. 


You can set the top, bottom, left side, and width of the text window by 
storing the appropriate values into four locations in memory. This enables 
your programs to control the placement of text in the display and to protect 
other portions of the screen from being written over by new text. 


Memory location 32 (hexadecimal $20) contains the number of the leftmost 
column in the text window. This number is normally 0, the number of the 
leftmost column in the display. In a 40-column display, the maximum value 
for this number is 89 (hexadecimal $27); in an 80-column display, the 
maximum value is 79 (hexadecimal $4F). 


Memory location 33 (hexadecimal $21) holds the width of the text. window. 
For a 40-column display, it is normally 40 (hexadecimal $28); for an 
80-column display, it is normally 80 (hexadecimal $50). 


COUT! truncates the column width to an even value on the original 
Apple Ile. 
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AWarning 


AWarning 


On an original Apple Ile, be careful not to let the sum of the window 
width and the leftmost position in the window exceed the width of the 


display you are using (40 or 80). If this happens, it is possible for COUT1 
to put characters into memory locations outside the display page, possibly 


into your current program or data space. 


Memory location 34 (hexadecimal $22) contains the number of the top line 
of the text window. This is normally 0, the topmost line in the display. Its 


maximum value is 23 (hexadecimal $17). 


Memory location 35 (hexadecimal $23) contains the number of the bottom 
line of the screen, plus 1. It is normally 24 (hexadecimal $18) for the bottom 


line of the display. Its minimum value is 1. 


After you have changed the text window boundaries, nothing is affected 
until you send a character to the screen. 


Any time you change the boundaries of the text window, you should 


make sure that the current cursor position (stored at CH and CV) is inside 
the new window. If it is outside, it is possible for COUT 1 to put characters 


into memory locations outside the display page, possibly destroying 


programs or data. 


Table 3-4 summarizes the memory locations and the possible values for the 
window parameters. 


Table 3-4. Text Window Memory Locations 


Window 
Parameter 


Left Edge 
Width 

Top Edge 
Bottom Edge 


Location 
Dec Hex 
82 =: $20 
83 «$21 
84 = $22 
85 «$28 


Minimum 
Value 
Dec Hex 
00 $00 
00 $00 
00 $00 
01 $01 


Normal Values 
40 col. 80 col. 
Dec Hex Dec Hex 
00 $00 00 $00 
4() $28 80 $50 
00 $00 00 $00 
24 $18 24 $18 
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Maximum Values 
40 col. 80 col. 
Dec Hex Dec Hex 
39 $27 19 $4F 
40 $28 80) $50 
Ze $17 23 $17 
24 $18 24 $18 
bd 


o6 


Important! 


Inverse and Flashing Text 

a ead 

Subroutine COUT! can display text in normal format, inverse format, or, 
with some restrictions, flashing format. The display format for any 
character in the display depends on two things: the character set being used 
at the moment, and the setting of the two high-order bits of the character’s 
byte in the display memory. 


As it sends your text characters to the display, COUT1 sets the high-order 
bits according to the value stored at memory location 50 (hexadecimal $32). 
If that value is 255 (hexadecimal $FF), COUT] sets the characters to 
display in normal format; if the value is 63 (hexadecimal $3F), COUT! sets 
the characters to inverse format. If the value is 127 (hexadecimal $7F) and 
if you have selected the primary character set, the characters will be 
displayed in flashing format. Note that flashing format is not available in 
the alternate character set. 


Table 3-5. Text Format Control Values 


Note: These mask values apply only to the primary character set (see text). 


Mask Value 
Dec Hex Display Format 
255 $FF Normal, uppercase, and lowercase 
127 $7F Flashing, uppercase, and symbols 
63 $3F Inverse, uppercase, and lowercase 


To control the display format of the characters, routine COUT1 uses the 
value at location 50 as a logical mask to force the setting of the two 
high-order bits of each character byte it puts into the display page. It does 
this by performing the logical AND function on the data byte and the mask 
byte. The result byte contains a 0 in any bit that was 0 in the mask. 
BASICOUT, used when the 80-column firmware is active, changes only the 
high-order bit of the data. 


If the 80-column firmware is inactive and you store a mask value at 
location 50 with zeros in its low-order bits, COUT1 will mask out those 
bits in your text. As a result, some characters will be transformed into 
other characters. You should set the mask to the values given in Table 8-5 
only. 
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Switching between character sets is 
described in the section “Display Mode 
Switching” in Chapter 2. 


Original lle 


If you set the mask value at location 50 to 127 (hexadecimal $7F), the 
high-order bit of each result byte will be 0, and the characters will be 
displayed either as lowercase or as flashing, depending on which character 
set you have selected. Refer to the tables of display character sets in 
Chapter 2. In the primary character set, the next-highest bit, bit 6, selects 
flashing format with uppercase characters. With the primary character set 
you can display lowercase characters in normal format and uppercase 
characters in normal, inverse, and flashing formats. In the alternate 
character set, bit 6 selects lowercase or special characters. With the 
alternate character set you can display uppercase and lowercase characters 
in normal and inverse formats. 


On the original Apple Ile, the MouseText characters are replaced by 
uppercase inverse characters. 
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For more information on GETLN, see the 
section “Editing With GETLN,” later in this 
chapter. 


The Apple Ile’s firmware includes two different subroutines for reading 
from the keyboard. One subroutine is named RDKEY, which stands for 
read key. \t calls the standard character input subroutine KEYIN (or 
BASICIN when the 80-column firmware is active) which accepts one 
character at a time from the keyboard. 


The other subroutine is named GETLN, which stands for get line. By 
making repeated calls to RDKEY, GETLN accepts a sequence of characters 
terminated with a carriage return. GETLN also provides on-screen editing 
features. 


RDKEY Input Subroutine 

SaaS ee ee ee 

A program gets a character from the keyboard by making a subroutine call 
to RDKEY at memory location $FD0C. RDKBY sets the character at the 
cursor position to flash, then passes control via the input link KSW to the 
current input subroutine, which is normally KEYIN or BASICIN. 


RDKEY displays a cursor at the current cursor position, which is 
immediately to the right of whatever character you last sent to the display 
(normally by using the COUT routine, described earlier). The cursor 
displayed by RDKEY is a flashing version of whatever character happens to 
be at that position on the screen. It is usually a space, so the cursor appears 
as a blinking rectangle. 
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Escape mode is described in the next 
section, “Escape Codes.” 
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KEYIN Input Subroutine 


SS SS Se eee 

KEYIN is the standard input subroutine when the 80-column firmware is 
inactive; BASICIN is used when the 80-column firmware is active. When 
called, the subroutine waits until the user presses a key, then returns with 
the key code in the accumulator. 


If the 80-column firmware is inactive, KEYIN displays a cursor by 
alternately storing a checkerboard block in the cursor location, then storing 
the original character, then the checkerboard again. If the firmware is 
active, BASICIN displays a steady inverse space (rectangle), unless you are 
in escape mode, when it displays a plus sign (+) in inverse format. 


KEYIN also generates a random number. While it is waiting for the user to 
press a key, KEYIN repeatedly increments the 16-bit number in memory 
locations 78 and 79 (hexadecimal $4E and $4F). This number keeps 
increasing from 0 to 65535, then starts over again at 0. The value of this 
number changes so rapidly that there is no way to predict what it will be 
after a key is pressed. A program that reads from the keyboard can use this 
value as a random number or as a seed for a random number routine. 


When the user presses a key, KEYIN accepts the character, stops displaying 
the cursor, and returns to the calling program with the character in the 
accumulator. 


Escape Codes 


KEYIN has special functions that you invoke by typing escape codes on the 
keyboard. An escape code is obtained by pressing [ESC], releasing it, and 
then pressing some other key. See Table 3-6; the notation in the table means 
press [ESC], release it, then press the key that follows. 


Table 3-6 includes three sets of cursor-control keys. The first set consists of 
followed by A, B, C, or D. The letter keys can be either uppercase or 
lowercase. These keys are the standard cursor-motion keys on older 

Apple II models; they are present on the Apple Ile primarily for 
compatibility with programs written for old machines. 


Cursor Motion in Escape Mode 


The second and third set of cursor-control keys are listed together because 
they activate escape mode. In escape mode, you can keep using the 
cursor-motion keys without pressing again. This enables you to 
perform repeated cursor moves by holding down the appropriate k ey. 
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Table 3-6. Escape Codes 


Escape Code 
Le] 


[Esc }[A] or [a] 

(Esc }[B} or (b] 
[Esc}(c}or(c} 
[Esc}(D}or(a} 

(esc }(E}or[e} 

[esc }[F] or (4) 

[esc ](1J or (iJ or (esc}{+} 
(esc }[J} or (jJ or esc} [~] 
[esc }[k] or [k] or (Esc ][+] 
[esc ](m} or(m] or (esc) [) 
[esc ][4] 


[ESC ][CONTROL }{D ] 


[ESC ][CONTROL }[E ] 
[Esc [CONTROL }{@ ] 


When the 80-column firmware is active, you can tell when BASICIN is in 
escape mode: it displays a plus sign in inverse format as the cursor. You 
leave escape mode by typing any key other than a cursor-motion key. 


The escape codes with the directional arrow keys are the standard 
cursor-motion keys on the Apple Ile. The escape codes with the I, J, K, and 
M keys are the standard cursor-motion keys on the Apple II Plus, and are 
present on the Apple [le for compatibility with the Apple II Plus. On the 
Apple Ile, the escape codes with the I, J, K, and M keys function with either 
uppercase or lowercase letters. 


Function 


Clears window and homes cursor (places it in upper-left corner of screen), then exits from 
escape mode. 


Moves cursor right one line; exits from escape mode. 

Moves cursor left one line; exits from escape mode. 

Moves cursor down one line; exits from escape mode. 

Moves cursor up one line; exits from escape mode. 

Clears to end of line; exits from escape mode. 

Clears to bottom of window; exits from escape mode. 

Moves the cursor up one line; remains in escape mode. See text. 
Moves the cursor left one space; remains in escape mode. See text. 
Moves the cursor right one space; remains in escape mode. See text. 
Moves the cursor down one line; remains in escape mode. See text. 


If 80-column firmware is active, switches to 40-column mode; sets links to BASICIN and 
BASICOUT; restores normal window size; exits from escape mode. 


If 80-column firmware is active, switches to 80-column mode; sets links to BASICIN and 
BASICOUT; restores normal window size; exits from escape mode. 


Disables control characters; only carriage return, line feed, BELL, and backspace have an 
effect when printed. 


Reactivates control characters. 


If 80-column firmware is active, deactivates 80-column firmware; sets links to KEYIN and 
COUT1; restores normal window size; exits from escape mode. 
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GETLN Input Subroutine 


Programs often need strings of characters as input. While it is pos sible to 
call RDKEY repeatedly to get several characters from the keyboard, there is 
a more powerful subroutine you can use. This routine is named GETLN, 
which stands for get /2ne, and starts at location $FD6A. Using repeated 
calls to RDKEY, GETLN accepts characters from the standard input 
subroutine—usually KEYIN—and puts them into the input buffer located 
in the memory page from $200 to $2FF. GETLN also provides the user with 
on-screen editing and control features, described in the next section 
“Editing With GETLN.” 


The first thing GETLN does when you call it is display a prompting 
character, called simply a prompt. The prompt indicates to the user that 
the program is waiting for input. Different programs use different prompt 
characters, helping to remind the user which program is requesting the 
input. For example, an INPUT statement in a BASIC program displays a 
question mark ( ? ) as a prompt. The prompt characters used by the 
different programs on the Apple Ile are shown in Table 3-7. 


GETLN uses the character stored at memory location 51 (hexadecimal $33) 
as the prompt character. In an assembly-language program, you can change 
the prompt to any character you wish. In BASIC, changing the prompt 
character has no effect, because both BASIC interpreters and the Monitor 
restore it each time they request input from the user. 


Table 3-7. Prompt Characters 


Prompt Character Program Requesting Input 


i User’s BASIC program (INPUT statement) 
Applesoft BASIC (Appendix D) 
> Integer BASIC (Appendix D) 

* Firmware Monitor (Chapter 5) 


As you type the character string, GETLN sends each character to the 
standard output routine—normally COUT 1—which displays it at the 
previous cursor position and puts the cursor at the next available position 
on the display, usually immediately to the right. As the cursor travels across 
the display, it indicates the position where the next character willl be 
displayed. 
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important! 


GETLN stores the characters in its buffer, starting at memory location $200 
and using the X register to index the buffer. GETLN continues to accept and 
display characters until you press (RETURN }; then it clears the remainder of 
the line the cursor is on, stores the carriage-return code in the buffer, sends 
the carriage-return code to the display, and returns to the calling program. 


The maximum line-length that GETLN can handle is 255 characters. If the 
user types more than this, GETLN sends a backslash ( \ ) and a carriage 
return to the display, cancels the line it has accepted so far, and starts over. 
To warn the user that the line is getting full, GETLN sounds a bell (tone) at 
every keypress after the 248th. 


In the Apple II and the Apple II Plus, the GETLN routine converts all 
input to uppercase. GETLN in the Apple Ile does not do this, even in 
Apple II mode. To get uppercase input for BASIC, use (CAPS LOCK]. 


Editing With GETLN 


aaa Se ee ey 

Subroutine GETLN provides the standard on-screen editing features used 
by the BASIC interpreters and the Monitor. For an introduction to editing 
with these features, refer to the Applesoft Tutorial. Any program that uses 
GETLN for reading the keyboard has these features. 


Cancel Line 


Any time you are typing a line, pressing causes GETLN to 
cancel the line. GETLN displays a backslash ( \ ) and issues a carriage 
return, then displays the prompt and waits for you to type a new line. 
GETLN takes the same action when you type more than 255 characters, as 
described earlier. 


Backspace 


When you press (~], GETLN moves its buffer pointer back one space, 
effectively deleting the last character in its buffer. It also sends a backspace 
character to routine COUT, which moves the display position and the cursor 
back one space. If you type another character now, it will replace the 
character you backspaced over, both on the display and in the line buffer. 
Each time you press [=], it moves the cursor left and deletes another 
character, until you reach the beginning of the line. If you then press [~} 
one more time, you have cancelled the line, and GETLN issues a carriage 
return and displays the prompt. 
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Retype 


has a function complementary to the backspace function. When you 
press [+], GETLN picks up the character at the display position just as if it 
had been typed on the keyboard. You can use this procedure to pick up 
characters that you have just deleted by backspacing across them. You can 
use the backspace and retype functions with the cursor-motion functions to 
edit data on the display. (See the earlier section “Cursor Motion in. Escape 
Mode.”) 
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Table 3-8 summarizes the addresses and functions of the video display 
support routines the Monitor provides. These routines are described in the 
subsections that follow. 


Table 3-8. Video Firmware Routines 


Location Name Description 

$C307 BASICOUT Displays a character on the screen when 
80-column firmware is active. 

$FC9C CLREOL Clears to end of line from current cursor 
position. 

SFC9E CLEOLZ Clears to end of line using contents of Y register 
as Cursor position. 

$FC42 CLREOP Clears to bottom of window. 

$F 832 CLRSCR Clears the low-resolution screen. 

$F836 CLRTOP Clears top 40 lines of low-resolution screen. 

$FDED COUT Calls output routine whose address is stored in 
CSW (normally COUT1, Chapter 3). 

$FDFO COUT] Displays a character on the screen (Chapter 3). 

$FD8E CROUT Generates a carriage return character. 

$FD8B CROUT 1 Clears to end of line, then generates a carriage 
return character. 

$F819 HLINE Draws a horizontal line of blocks. 
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Table 3-8—Continued. Video Firmware Routines 


Location 


SFC58 


S800 
SFO4A 


SFDDA 
SFF2D 


$FDES 
$F941 
$F871 


$F864 
$FC24 


$F828 


BASICOUT, $C307 


Name 


HOME 


PLOT 
PRBL2 


PRBYTE 
PRERR 


PRHEX 
PRNTAX 
SCRN 


SETCOL 
VTABZ 


VLINE 


Description 


Clears the window and puts cursor in upper-left 
corner of window. 


Plots a single low-resolution block on the screen. 


Sends | to 256 blank spaces to the output device 
whose address is in CSW. 


Prints a hexadecimal byte. 


Sends ERR and Control-G to the output device 
whose output routine address is in CSW. 


Prints 4 bits as a hexadecimal number. 
Prints contents of A and X in hexadecimal. 


Reads color value of a low-resolution block on 
the screen. 


Sets the color for plotting in low-resolution. 


Sets cursor vertical position. (Setting CV at 
location $25 does not change vertical positon 
until a carriage return. ) 


Draws a vertical line of low-resolution blocks. 


BASICOUT is essentially the same as COUT1—BASICOUT is used instead 
of COUT1 when the 80-column firmware is active. BASICOUT displays the 
character in the accumulator on the display screen at the current cursor 
position and advances the cursor. It places the character using the setting of 
the inverse mask (location $32). BASICOUT handles control characters; see 
Table 3-3b. When it returns control to the calling program, all registers are 


intact. 


CLREOL, $FC9C 


CLREOL clears a text line from the cursor position to the right edge of the 
window. This routine destroys the contents of A and Y. 
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See the section “Control Characters With 
COUT1 and BASICOUT,” earlier in this 
chapter for more information on COUT]. 
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CLEOLZ, $FC9E 


CLEOLZ clears a text line to the right edge of the window, starting at the 
location given by base address BASL, which is indexed by the contents of 
the Y register. This routine destroys the contents of A and Y. 


CLREOP, $FC42 


CLREOP clears the text window from the cursor position to the bottom of 
the window. This routine destroys the contents of A and Y. 


CLRSCR, $F832 


CLRSCR clears the low-resolution graphics display to black. If you call this 
routine while the video display is in text mode, it fills the screen with 
inverse-mode at-sign ((@) characters. This routine destroys the contents 
of A and Y. 


CLRTOP, $F836 


CLRTOP is the same as CLRSCR, except that it clears only the top 40 rows 
of the low-resolution display. 


COUT, $FDED 


COUT calls the current character output subroutine. (See the section 
“COUT Output Subroutine’ earlier in this chapter.) The character to be sent 
to the output device should be in the accumulator. COUT calls the 
subroutine whose address is stored in CSW (locations $36 and $87 ), which 
is usually the standard character output subroutine COUT1 (or BASICOUT). 


COUT1, $FDFO 


COUT] displays the character in the accumulator on the display screen at 
the current cursor position and advances the cursor. It places the character 
using the setting of the inverse mask (location $32). It handles these control 
characters: carriage return, line feed, backspace, and bell. When it returns 
control to the calling program, all registers are intact. 


CROUT, $FD8E 


CROUT sends a carriage return to the current output device. 
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CROUT1, $FD8B 


CROUT!1 clears the screen from the current cursor position to the edge of 
the text window, then calls CROUT. 


HLINE, $F819 


HLINE draws a horizontal line of blocks of the color set by SETCOL on the 
low-resolution graphics display. Call HLINE with the vertical coordinate of 
the line in the accumulator, the leftmost horizontal coordinate in the 

Y register, and the rightmost horizontal coordinate in location $2C. HLINE 
returns with A and Y scrambled and X intact. 


HOME, $FC58 


HOME clears the display and puts the cursor in the upper-left corner of the 
screen. 


PLOT, $F800 


PLOT puts a single block of the color value set by SETCOL on the 
low-resolution display screen. Call PLOT with the vertical coordinate of the 
line in the accumulator, and its horizontal position in the Y register. PLOT 
returns with the accumulator scrambled, but X and Y intact. 


PRBL2, $F94A 


PRBL2 sends from 1 to 256 blanks to the standard output device. Upon 
entry, the X register should contain the number of blanks to send. If 
X = $00, then PRBLANK will send 256 blanks. 


PRBYTE, $FDDA 


PRBYTE sends the contents of the accumulator in hexadecimal to the 
current output device. The contents of the accumulator are scrambled. 


PRERR, $FF2D 


PRERR sends the word ERR, followed by a bell character, to the standard 
output device. On return, the accumulator is scrambled. 
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PRHEX, $FDE3 


PRHEX prints the lower nibble of the byte in the accumulator as a single 
hexadecimal digit. On return, the contents of the accumulator are 
scrambled. 


PRNTAX, $F941 


PRT AX prints the contents of the A and X registers as a four-digit 
hexadecimal value. The accumulator contains the first byte printed, and 
the X register contains the second. On return, the contents of the 
accumulator are scrambled. 


SCRN, $F871 


SCRN returns the color value of a single block on the low-resolution display. 
Call it with the vertical position of the block in the accumulator and the 
horizontal position in the Y register. The block’s color is returned in the 
accumulator. No other registers are changed. 


SETCOL, $F864 


SETCOL sets the color used for plotting in low-resolution graphics to the 
value passed in the acumulator. The colors and their values are listed in 
Table 2-6. 


VTABZ, $FC24 


VTABZ sets the cursor vertical position. Unlike setting the position at 
location $25, change of cursor position doesn’t wait until a carriage return 
character has been sent. 


VLINE, $F828 


VLINE draws a vertical line of blocks of the color set by SETCOL on the 
low-resolution display. Call VLINE with the horizontal coordinate of the line 
in the Y register, the top vertical coordinate in the accumulator, and the 
bottom vertical coordinate in location $2D. VLINE returns with the 
accumulator scrambled. 
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1/O Firmware Support 
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Apple Ile video firmware conforms to the I/O firmware protocol of Apple II 
Pascal 1.1. However, it does not support windows other than the full 
80-by-24 window in 80-column mode, and the full 40-by-24 window in 
40-column mode. The video protocol table is shown in Table 3-9. 


Table 3-9. Slot 3 Firmware Protocol Table 


Address Value Description 

$C30B ~—Ss $001 Generic signature byte of firmware cards 

$C30C ~—s-_: $88 80-column card device signature 

$C30D _iSii $C3ii is entry point of initialization routine (PINIT). 
$C30E —s $rr $C3rr is entry point of read routine (PREAD). 

$C30F $ww  $C3wwisentry point of write routine (PWRITE). 
$C310  — $ss $C8ss is entry point of the status routine (PSTATUS). 


PINIT, $C30D 
PINIT does the following: 


O Sets a full 80-column window. 

Oo Sets 80STORE ($C001). 

o Sets 80COL ($CO00D). 

Oo Switches on ALTCHAR ($CO0F). 

O Clears the screen; places cursor in upper-left corner. 
oO Displays the cursor. 


PREAD, $C30E 


PREAD reads a character from the keyboard and places it in the 
accumulator with the high bit cleared. It also puts a zero in the X register to 
indicate IORESULT = GOOD. 
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PWRITE, $C30F 


PWRITE should be called after placing a character in the accumulator with 
its high bit cleared. PWRITE does the following: 


o Turns the cursor off. 


o If the character in the accumulator is not a control character, turns the 
high bit on for normal display or off for inverse display, displays it at the 
current cursor position, and advances the cursor; if at the end of a line, 
does carriage return but not line feed. (See Table 3-10 for control 
character functions. ) 


When PWRITE has completed this, it 


o turns the cursor back on (if it was not intentionally turned off) 


O puts a zero in the X register JORESULT = GOOD) and returns to the 
calling program. 


Table 3-10. Pascal Video Control Functions 


Control- Hex Function Performed 

Eore $05 Turns cursor on (enables cursor display). 
F or f $06 Turns cursor off (disables cursor display). 
Gorg $07 Sounds bell (beeps). 


Horh $08 Moves cursor left one column. If cursor was at beginning of 
line, moves it to end of previous line. 


Jor] $0A Moves cursor down one row; scrolls if needed. 
Kork  $0B Clears to end of screen. 

Lor] $0C Clears screen; moves cursor to upper-left of screen. 
Morm $0D — Moves cursor to column 0. 


Norn $0E Displays subsequent characters in normal video. ( Characters 
already on display are unaffected. ) 
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Table 3-10—Continued. Pascal Video Control Functions 


Control- Hex 


Ooro SOF 
Vorv $16 
Worw = $17 
Yory $19 
Z or z SIA 
lor \ $1C 
bor] $1D 
“or6 = $1E 
zz $IF 


Function Performed 


Displays subsequent characters in inverse video. 
(Characters already on display are unaffected.) 


Scrolls screen up one line; clears bottom line. 

Scrolls screen down one line; clears top line. 

Moves cursor to upper-left (home) position on screen. 
Clears entire line that cursor is on. 


Moves cursor right one column; if at end of line, does 
Control-M. 


Clears to end of the line the cursor is on, including current 
Cursor position; does not move cursor. 


GOTOxy: initiates a GOTOxy sequence; interprets the next 
two characters as x+32 and y+82, respectively. 


If not at top of screen, moves cursor up one line. 


PSTATUS, $C310 


A program that calls PSTATUS must first put a request code in the 
accumulator: either a 0, meaning “Ready for output?” or a 1, meaning “Is 
there any input?” PSTATUS returns with the reply in the carry bit: 0 (No) 


or 1 (Yes). 


PSTATUS returns with a 0 in the X register (IORESULT = GOOD), unless 
the request was not 0 or 1; then PSTATUS returns with a 3 in the X register 
(IORESULT = ILLEGAL OPERATION). 


I/O Firmware Support 


69 


Chapter 4 


Memory Organization 


a! 


Original lle 


For details of the built-in 1/O features, refer 
to the descriptions in Chapters 2 and 3. 


For information about I/O operations with 
peripheral cards, refer to Chapter 6. 


The Apple Ile’s microprocessor can address 65,536 (64K) memory locations. 
All of the programmable storage (RAM and ROM) and input and output 
devices are allocated locations in this 64K address space. Some functions 
share the same addresses—but not at the same time. 


For information about these shared address spaces, see the section 
“Bank-Switched Memory” in this chapter and the sections “Other Uses of 
I/O Memory Space” and “Expansion ROM Space” in Chapter 6. 


The original version of the Apple Ile, as well as the Apple II Plus and 
Apple II, use the 6502 microprocessor. The 6502 lacks ten instructions 
and two addressing modes found on the 65C02 of the enhanced Apple Ile, 
but is otherwise functionally similar. For more information about the 
differences between the two processors, see Appendix A. In this manual, 
unless otherwise stated, the two processors are effectively the same. 


All input and output in the Apple Ile is memory mapped. This means that 
all devices connected to the Apple Ile appear to be memory locations to the 
computer. In this chapter, the I/O memory spaces are described simply as 
blocks of memory. 


Programmers often refer to the Apple Ile’s memory in 256-byte blocks called 
pages. One reason for this is that a one-byte address counter or index 
register can specify one of 256 different locations. Thus, page 0 consists of 
memory locations from 0 to 255 (hexadecimal $00 to $FF), inclusive. Page 1 
consists of locations 256 to 511 (hexadecimal $0100 to $01FF); note that the 
page number is the high-order part of the hexadecimal address. Don’t 
confuse this kind of page with the display buffers in the Apple IIe, which 
are sometimes referred to as Page 1 and Page 2. 


Main Memory Map 
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The map of the main memory address space in Figure 4-1 shows the 
functions of the major areas of memory. For more details on the I/O space 
from 48K to 52K ($C000 through $CFFF), refer to Chapter 2 and Chapter 6: 
the bank-switched memory in the memory space from 52K to 64K ($D000 
through $FFFF) is described in the section “Bank-Switched Memory” later 
in this chapter. 
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Figure 4-1. System Memory Map 
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RAM Memory Allocation 


As Figure 4-1 shows, the major portion of the Apple Ile’s memory space is 
allocated to programmable storage (RAM). Figure 4-2 shows the areas 
allocated to RAM. The main RAM memory extends from location 0 to 
location 49151 (hex $BFFF), and occupies pages 0 through 191 
(hexadecimal $BF). There is also RAM storage in the bank-switched space 
from 53248 to 65535 (hexadecimal $D000 to $FFFF), described in the 
section “Bank-Switched Memory” later in this chapter, and auxiliary RAM, 
described in the section “Auxiliary Memory and Firmware’ later in this 
chapter. 


Figure 4-2. RAM Allocation Map 
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Important! 


Reserved Memory Pages 


SESE = SS SSS 

Most of the Apple Ile’s RAM is available for storing your programs and data. 
However, a few RAM pages are reserved for the use of the Monitor firmware 
and the BASIC interpreters. The reserved pages are described in the 
following sections. 


The system does not prevent your using these pages, but if you do use 
them, you must be careful not to disturb the system data they contain, or 
you will cause the system to malfunction. 


Page Zero 


Several of the 65C02 microprocessor’s addressing modes require the use of 
addresses in page zero, also called zero page. The Monitor, the BASIC 
interpreters, DOS 3.3, and ProDOS all make extensive use of page zero. 


To use indirect addressing in your assembly-language programs, you must 
store base addresses in page zero. At the same time, you must avoid 
interfering with the other programs that use page zero—the Monitor, the 
BASIC interpreters, and the disk operating systems. One way to avoid 
conflicts is to use only those page-zero locations not already used by other 
programs. Tables 4-1 through 4-5 show the locations in page zero used by 
the Monitor, Applesoft BASIC, Integer BASIC, DOS 3.3, and ProDOS. 


As you can see from the tables, page zero is pretty well used up, except for a 
few bytes here and there. It’s hard to find more than one or two bytes that 
aren’t used by either BASIC, ProDOS, the Monitor, or DOS. Rather than 
trying to squeeze your data into an unused corner, you may prefer a safer 
alternative: save the contents of part of page zero, use that part, then 
restore the previous contents before you pass control to another program. 


The 65C02 Stack 


The 65C02 microprocessor uses page 1 as the stack—the place where 
subroutine return addresses are stored, in last-in, first-out sequence. Many 
programs also use the stack for temporary storage of the registers (via push 
and pull operations). You can do the same, but you should use it sparingly. 
The stack pointer is eight bits long, so the stack can hold only 256 bytes of 
information at a time. When you store the 257th byte in the stack, the stack 
pointer repeats itself, or wraps around, so that the new byte replaces the 
first byte stored, which is now lost. This writing over old data is called stack 
overflow, and when it happens, the program continues to run normally until 
the lost information is needed, whereupon the program terminates 
catastrophically. 


RAM Memory Allocation fis 


For more information about links, see the 


section “Changing the Standard I/O Links” 


in Chapter 6. 


See Chapter 6 for information on the 
memory locations that are reserved for 
peripheral cards. 


For more information about the display 
buffers, see the section “Video Display 
Pages” in Chapter 2. 
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The Input Buffer 


The GETLN input routine, which is used by the Monitor and the BASIC 
interpreters, uses page 2 as its keyboard-input buffer. The size of this buffer 
sets the maximum size of input strings. (Note: Applesoft uses only the first 
237 bytes, although it permits you to type in 256 characters.) If you know 
that you won't be typing any long input strings, you can store temporary 
data at the upper end of page 2. 


Link-Address Storage 


The Monitor, ProDOS, and DOS 8.3 all use the upper part of page 3 for link 
addresses or vectors. 


BASIC programs sometimes need short machine-language routines. These 
routines are usually stored in the lower part of page 3. 


The Display Buffers 


The primary text and low-resolution-graphics display buffer occupies 
memory pages 4 through 7 (locations 1024 through 2047, hexadecimal $0400 
through $07FF). This entire 1024-byte area is called text Page 1, and it is not 
usable for program and data storage. There are 64 locations in this area that 
are not displayed on the screen; these locations are reserved for use by the 
peripheral cards. 


Text Page 2, the alternate text and low-resolution-graphics display buffer, 
occupies memory pages 8 through 11 (locations 2048 through 3071, 
hexadecimal $0800 through $0BFF). Most programs do not use Page 2 for 
displays, so they can use this area for program or data storage. 


The primary high-resolution-graphics display buffer, called high-resolution 
Page 1, occupies memory pages 32 through 63 (locations 8192 through 
16383, hexadecimal $2000 through $3FFF). If your program doesnt use 
high-resolution graphics, this area is usable for programs or data. 


High-resolution Page 2 occupies memory pages 64 through 95 (locations 
16384 through 24575, hexadecimal $4000 through $5FFF). Most programs 
use this area for program or data storage. 


The primary double-high-resolution-graphics display buffer, called 
double-high-resolution Page 1, occupies memory pages 32 through 63 
(locations 8192 through 16383, hexadecimal $2000 through $8FFF') in both 
main and auxiliary memory. If your program doesn’t use high-reso lution or 
double-high-resolution graphics, this area of main memory is usabLe for 
programs or data. 
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Table 4-1. Monitor Zero-Page Use 


High Nibble 
of Address 


$00 
$10 
$20 
$30 
$40 
$50 
$60 
$70 
$80 
$90 
SA0 
$B0 
$C0 
$D0 
$0 
SFO 


Low Nibble of Address 


$0 $1 $2 $3 $4 $5 $6 $7 $8 $9 $A $B SC $D SE SF 


ex 
e e e °® e @ 2) @ @ o e e 
@ eo eo °®@ e @ e @ e oO e e 
@ oO e @ e @ e e 
@ ‘e) 


* Byte used in original Apple Ile ROMs, now free. 


Table 4-2. Applesoft Zero-Page Use 


High Nibble 
of Address 


$00 
$10 
$20 
$30 
$40 
$50 
$60 
$70 
$80 
$90 
SA0 
$B0 
$C0 
3D0 
$E0 
SFO 


$0 


RAM Memory Allocation 


Low Nibble of Address 
$4 $5 $6 $7 $8 $9 $A $B SC SD $E $F 


i 
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Table 4-3. Integer BASIC Zero-Page Use 


High Nibble Low Nibble of Address 


of Address $0 $1 $2 $3 $4 $5 $6 $7 $8 $9 $A $B SC $D $E $F 


$00 0 
$10 
$20 
$30 
$40 
$50 
$60 
$70 
$80 
$90 
$A0 
$B0 
$C0 
$D0 
SEO 
SFO 


Table 4-4. DOS 8.3 Zero-Page Use 


High Nibble Low Nibble of Address 
of Address $0 $1 $2 $3 $4 $5 $6 $7 $8 $9 $A $B SC $D SE 


$00 

$10 

$20 oO ® e ® @ ® ® 
$30 e e e @ e ® 
$40 ® @ ® ® @ e © e oO @ e e e 
$50 

$60 e e e oO 

370 © 

$80 

$90 

$A0 

$B0 ° 

$C0 e ® ® @ 
$D0 0 

SEO 

SFO 
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Table 4-5. ProDOS MLI and Disk-Driver Zero-Page Use 


High Nibble Low Nibble of Address 
of Address $0 $1 $2 $3 $4 $5 $6 $7 $8 $9 $A $B SC $D SE $F 


$00 ee 

$10 

$20 

$30 e @ e e e e 
$40 ® ® ® @ @ @ ® @ @ ® e @ ® © e 
$50 

$60 

$70 

$80 

$90 

SA0 

$B0 

$C0 

3D0 

$E0 

SFO 


Bank-Switched Memory 


The memory address space from 52K to 64K (hexadecimal $D000 through 
$FFFF) is doubly allocated: it is used for both ROM and RAM. The 12K bytes 
of ROM (read-only memory) in this address space contain the Monitor and 
the Applesoft BASIC interpreter. Alternatively, there are 16K bytes of RAM 
in this space. The RAM is normally used for storing either the Integer 
BASIC interpreter or part of the Pascal Operating System (purchased 
separately ). 


You may be wondering why this part of memory has such a split 
personality. Some of the reasons are historical: the Apple Ile is able to run 
software written for the Apple II and Apple II Plus because it uses this part 
of memory in the same way they do. It is convenient to have the Applesoft 
interpreter in ROM, but the Apple Ile, like an Apple II with a language card, 
is also able to use that address space for other things when Applesoft is not 
needed. 


Bank-Switched Memory 19 


80 


AWarning 


You may also be wondering how 16K bytes of RAM is mapped into only 12K 
bytes of address space. The usual answer is that it’s done with mirrors, and 
that isn’t a bad analogy: the 4K-byte address space from 52K to 56K 
(hexadecimal $D000 through $DFFF) is used twice. 


Switching different blocks of memory into the same address space is called 
bank switching. There are actually two examples of bank switching going 
on here: first, the entire address space from 52K to 64K ($D000 through 
$FFFF) is switched between ROM and RAM, and second, the address space 
from 52K to 56K ($D000 to $DFFF) is switched between two different 
blocks of RAM. 


Figure 4-3. Bank-Switched Memory Map 


Setting Bank Switches 


(eee ak Se ee en a | 

You switch banks of memory in the same way you switch other functions in 
the Apple Ile: by using soft switches. Read operations to these soft switches 
do three things: select either RAM or ROM in this memory space; enable or 
inhibit writing to the RAM (write-protect); and select the first or second 
4K-byte bank of RAM in the address space $D000 to $DFFF. 


Do not use these switches without careful planning. Careless switching 
between RAM and ROM is almost certain to have catastrophic effects on 
your program. 
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Table 4-6 shows the addresses of the soft switches for enabling all 
combinations of reading and writing in this memory space. All of the 
hexadecimal values of the addresses are of the form $C08x. Notice that 
several addresses perform the same function: this is because the functions 
are activated by single address bits. For example, any address of the form 
$C08x with a 1 in the low-order bit enables the RAM for writing. Similarly, 
bit 3 of the address selects which 4K block of RAM to use for the address 
space $D000-$DFFF; if bit 3 is 0, the first bank of RAM is used, and if bit 3 
is 1, the second bank is used. 


When RAM is not enabled for reading, the ROM in this address space is 
enabled. Even when RAM is not enabled for reading, it can still be written to 
if it is write-enabled. 


When you turn power on or reset the Apple Ile, it initializes the bank 
switches for reading the ROM and writing the RAM, using the second bank 
of RAM. Note that this is different from the reset on the Apple II Plus, which 
didn’t affect the bank-switched memory (the language card). On the 

Apple Ile, you can’t use the reset vector to return control to a program in 
bank-switched memory, as you could on the Apple II Plus. 


Reset With Integer BASIC: When you are using Integer BASIC on the 
Apple Ile, reset works correctly, restarting BASIC with your program 
intact. This happens because the reset vector transfers control to DOS, 
and DOS resets the switches for the current version of BASIC. 
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Table 4-6. Bank Select Switches 


Note: R means read the location, W means write anything to the location, R/W 
means read or write, and R7 means read the location and then check bit 7. 


Name Action Hex Function 

R $C080 Read RAM; no write; use $D000 bank 2. 
RR $C081 Read ROM; write RAM; use $D000 bank 2. 
R $C082 Read ROM; no write; use $D000 bank 2. 
RR $C0838 Read and write RAM; use $D000 bank 2. 
R $C088 Read RAM; no write; use $D000 bank 1. 
RR $C089 Read ROM; write RAM; use $D000 bank 1. 
R $C08A Read ROM; no write; use $D000 bank 1. 


RR $C08B _—«Read and write RAM; use $D000 bank 1. 
RDBNK2 ~—R7 $CO11 Read whether $D000 bank 2.(1) or bank 1 (0). 


RDLCRAM R7 $C012 Reading RAM (1) or ROM (0). 

ALTZP W $C008 Off: use main bank, page 0 and page 1. 
ALTZP W $C009 On: use auxiliary bank, page 0 and page 1. 
RDALTZP = R7 $C016 Read whether auxiliary (1) or main (0) bank. 


Reading and Writing to RAM Banks: Note that you can’t read one 
RAM bank and write to the other; if you select either RAM bank for 
reading, you get that one for writing as well. 


Reading RAM and ROM: You can’t read from ROM in part of the 
bank-switched memory and read from RAM in the rest: specifically, you 
can’t read the Monitor in ROM while reading bank-switched RAM. If you 
want to use the Monitor firmware with a program in bank-switched RAM, 
copy the Monitor from ROM (locations $F800 through $FFCB) into 
bank-switched RAM. You can’t do this from Pascal or ProDOS. 
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C8 
C8 


C9 


C8 
C9 


C8 


C9 


C8 


C9 


Cé 
Cé 


C9 


LDA 
LDA 
LDA 
STA 
LDA 
STA 
JSR 


LDA 
JSR 


LDA 
LDA 
INC 
JSR 


LDA 
INC 
LDA 
JSR 


LDA 
LDA 
INC 
INC 
LDA 
JSR 


To see how to use these switches, look at the following section of an 
assembly-language program: 


$C 983 *SELECT 2@ND 4K BANK & READ/WRITE 
$C883 *BY TWO CONSECUTIVE READS 

#$D8 "SET UPs« 

BEGIN * as NEW... 

*SFF *...MAIN-MEMORY... 

END *,..-POINTERS... 

RAMTST *...FOR 12K BANK 

$CO8B *SELECT 1ST 4K BANK 

RAMTST *USE ABOVE POINTERS 

$C 888 *SELECT 1ST BANK & WRITE PROTECT 
#$80 

TSTNUM 

WPTSINIT 

$C 080 *SELECT 2@ND BANK & WRITE PROTECT 
TSTNUM 

#PAT12K 

WPTSINIT 

$CO8B *SELECT 1ST BANK & READ/WRITE 
$CO88B *BY TWO CONSECUTIVE READS 

RWMODE *FLAG RAM IN READ/WRITE 

TSTNUM 

#PAT4K 

WPTSINIT 


The LDA instruction, which performs a read operation to the specified 
memory location, is used for setting the soft switches. The unusual 
sequence of two consecutive LDA instructions performs the two 
consecutive reads that write-enable this area of RAM; in this case, the data 
that are read are not used. 


Reading Bank Switches 
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You can read which language card bank is currently switched in by reading 
the soft switch at $C011. You can find out whether the language card or 
ROM is switched in by reading $C012. The only way that you can find out 
whether the language card RAM is write-enabled or not is by trying to write 
some data to the card’s RAM space. 
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Auxiliary Memory and Firmware 

I a ea ee ea ee ee eee 
By installing an optional card in the auxiliary slot, you can add more 
memory to the Apple Ie. One such card is the Apple Ile 80-Column Text 
Card, which has 1K bytes of additional RAM for expanding the text display 
from 40 columns to 80 columns. 


Another optional card, the Apple Ile Extended 80-Column Text Card, has 
64K of additional RAM. A 1K-byte area of this memory serves the same 
purpose as the memory on the 80-Column Text Card: expanding the text 
display to 80 columns. The other 63K bytes can be used as auxiliary 
program and data storage. If you use only 40-column displays, the entire 
64K bytes is available for programs and data. 


AWanrning Do not attempt to use the auxiliary memory from a BASIC program. The 
BASIC interpreter uses several areas in main RAM, including the stack 
and the zero page. If you switch to auxiliary memory in these areas, the 
BASIC interpreter fails and you must reset the system and start over. 


As you can see by studying the memory map in Figure 4-4, the au xiliary 
memory is broken into two large sections and one small one. The largest 
section is switched into the memory address space from 512 to 49151 ($0200 
through $BFFF). This space includes the display buffer pages: as described 
in the section “Text Modes” in Chapter 2, space in auxiliary memory is used 
for one half of the 80-column text display. You can switch to the auxiliary 
memory for this entire memory space, or you can switch just the display 
pages: see the next section, “Memory Mode Switching.” 


Soft Switches: If the only reason you are using auxiliary memory 1s for 
the 80-column display, note that you can store into the display page in 
auxiliary memory by using the 80STORE and PAGE2 soft switches 
described in the section “Display Mode Switching” in Chapter 2. 


The other large section of auxiliary memory is switched into the memory 
address space from 52K to 64K ($D000 through $FFFF). This mernory space 
and the switches that control it are described earlier in this chapter in the 
section “Bank-Switched Memory.” If you use the auxiliary RAM im this 
space, the soft switches have the same effect on the auxiliary RAM that 
they do on the main RAM: the bank switching is independent of the 
auxiliary-RAM switching. 
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Figure 4-4. Memory Map With Auxiliary Memory 
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Bank Switches: Note that the soft switches for the bank-switched 
memory, described in the previous section, do not change when you 
switch to auxiliary RAM. In particular, if ROM is enabled in the 
bank-switched memory space before you switch to auxiliary memory, the 
ROM will still be enabled after you switch. Any time you switch the 
bank-switched section of auxiliary memory in and out, you must also 
make sure that the bank switches are set properly. 


When you switch in the auxiliary RAM in the bank-switched space, you also 
switch the first two pages, from 0 to 511 ($0000 through $01FF). This part 
of memory contains page zero, which is used for important data and base 
addresses, and page one, which is the 65C02 stack. The stack and zero page 
are switched this way so that system software running in the 
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bank-switched memory space can maintain its own stack and zero page 
while it manipulates the 48K address space (from $0200 to $BFFF’) in either 
main memory or auxiliary memory. 


Memory Mode Switching 


—S=S a eSeee ee 

Switching the 48K section of memory is performed by two soft switches: the 
switch named RAMRD selects main or auxiliary memory for reading, and 
the one named RAMWRT selects main or auxiliary memory for writing. As 
shown in Table 4-7, each switch has a pair of memory locations dedicated to 
it, one to select main memory, and the other to select auxiliary memory. 
Enabling the read and write functions independently makes it possible for a 
program whose instructions are being fetched from one memory space to 
store data into the other memory space. 


Do not use these switches without careful planning. Careless switching 
between main and auxiliary memories is almost certain to have 
catastrophic effects on the operation of the Apple Ile. For example, if you 
switch to auxiliary memory with no card in the slot, the program that is 
running will stop and you will have to reset the Apple Ile and start over. 


Writing to the soft switch at location $C003 turns RAMRD on and enables 
auxiliary memory for reading: writing to location $C002 turns RAMRD off 
and enables main memory for reading. Writing to the soft switch at location 
$C005 turns RAMWRT on and enables the auxiliary memory for writing; 
writing to location $C004 turns RAMWRT off and enables main memory for 
writing. By setting these switches independently, you can use any of the 
four combinations of reading and writing in main or auxiliary memory. 


Auxiliary memory corresponding to text Page 1 and high-resolution graphics 
Page 1 can be used as part of the address space from $0200 to $BF FF by 
using RAMRD and RAMWRT as described above. These areas in auxiliary 
RAM can also be controlled separately by using the switches described in 
the section “Display Mode Switching” in Chapter 2. Those switches are 
named 80STORE, PAGE2, and HIRES. 


As shown in Table 4-7, the 80STORE switch functions as an enabling 
switch: with it on, the PAGE2 switch selects main memory or auxiliary 
memory. With the HIRES switch off, the memory space switched by PAGE2 
is the text Page 1, from $0400 to $07FF; with HIRES on, PAGE2 switches 
both text Page 1 and high-resolution graphics Page 1, from $2000 to $3FFF. 


If you are using both the auxiliary-RAM control switches and the 
auxiliary-display-page control switches, the display-page control switches 
take priority: if 830STORE is off, RAMRD and RAMWRT work for the entire 
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The next section, “Auxiliary-Memory 
Subroutines,” describes firmware that you 
can call to help you switch between main 
and auxiliary memory. 


memory space from $0200 to $BFFF, but if 80STORE is on, RAMRD and 
RAMWERT have no effect on the display page. Specifically, if 80STORE is on 
and HIRES is off, PAGE2 controls text Page 1 regardless of the settings of 
RAMRD and RAMWRT. Likewise, if 80STORE and HIRES are both on, 
PAGE2 controls both text Page 1 and high-resolution graphics Page 1, again 
regardless of RAMRD and RAMWRT. 


A single soft switch named ALTZP (for alternate zero page) switches the 
bank-switched memory and the associated stack and zero page area 
between main and auxiliary memory. As shown in Table 4-7, writing to 
location $C009 turns ALTZP on and selects auxiliary-memory stack and 
zero page; writing to the soft switch at location $C008 turns ALTZP off and 
selects main-memory stack and zero page for both reading and writing. 


Table 4-7. Auxiliary-Memory Select Switches. 


Name Function Location Notes 
Hex Decimal 

RAMRD _ Read auxiliary memory $C0038 49155 -16381 Write 
Read main memory $0002 49154 -16382 Write 
Read RAMRD switch $0013 49171 -16865 Read 

RAMWRT Write auxiliary memory $C005 49157 + -16879 Write 
Write main memory $C004 49156 -16880 Write 
Read RAMWRT switch $0014 49172 -163854 Read 

SOSTORE On: access display page $C001 49153-16883 — Write 
Off: use RAMRD, RAMWRT  $C000 49152-16384 Write 
Read 80STORE switch $C018 49176 -16360 Read 


PAGE2 _ Page.2 on (aux. memory) $C055 492387 -16299 * 
Page 2 off (main memory) $C054 49236 -16800 * 
Read PAGE2 switch $C01C 49180 -16356 Read 


HIRES On: access high-res. pages $C057 49239 -16297 ft 
Off: use RAMRD, RAMWRT _ $C056 49238  -16298 t 


Read HIRES switch $COID 49181 -16855 Read 
ALTZP Auxiliary stack & z.p. $C009 49161 -16373 ~~ Write 
Main stack & zero page $C008 49160 -16874 Write 
Read ALTZP switch $C016 49174 -16852 Read 


* When 80STORE is on, the PAGE2 switch selects main or auxiliary display memory. 


Tt When 80STORE is on, the HIRES switch enables you to use the PAGE2 switch to switch 
between the high-resolution Page-1 area in main memory or auxiliary memory. 


Auxiliary Memory and Firmware 87 


When these switches are on, auxiliary 
memory is being used; when they are off, 


main memory is being used. 
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important! 


There are three more locations associated with the auxiliary-memory 
switches. The high-order bits of the bytes you read at these locations tell 
you the settings of the three soft switches described above. The byte you 
read at location $C013 has its high bit set to 1 if RAMRD is on (auxiliary 
memory is read-enabled), or 0 if RAMRD is off (the 48K block of main 
memory is read-enabled). The byte at location $C014 has its high bit set to 1 
if RAMWRT is on (auxiliary memory is write-enabled), or 0 if RAMWRT is 
off (the 48K block of main memory is write-enabled). The byte at location 
$C016 has its high bit set to 1 if ALTZP is on (the bank-switched area, stack, 
and zero page in the auxiliary memory are selected), or 0 if ALTZP is off 
(these areas in main memory are selected). 


Sharing Memory: In order to have enough memory locations for all of 
the soft switches and remain compatible with the Apple II and 

Apple II Plus, the soft switches listed in Table 4-7 share their memory 
locations with the keyboard functions listed in Table 2-2. The 
operations—read or write—shown in Table 4-7 for controlling the 
auxiliary memory are just the ones that are not used for reading the 
keyboard and clearing the strobe. 


Auxiliary-Memory Subroutines 


SSS SSS ee 

If you want to write assembly-language programs that use auxiliary 
memory but you don’t want to manage the auxiliary memory yourself, you 
can use the built-in auxiliary-memory subroutines. These subroutines make 
it possible to use the auxiliary memory without having to manipulate the 
soft switches described in the previous section. 


The subroutines described below make it easier to use auxiliary memory, 
but they do not protect you from errors. You still have to plan your use of 
auxiliary memory to avoid catastrophic effects on your program. 


You use these built-in subroutines the same way you use the I/O 
subroutines described in Chapter 3: by making subroutine calls to their 
starting locations. Those locations are shown in Table 4-8. 


Table 4-8. 48K RAM Transfer Routines 


Name Action Hex Function 

AUXMOVE JSR $C312 Moves data blocks between main and 
auxiliary 48K memory. 

XFER JMP $C314 Transfers program control between main and 
auxiliary 48K memory. 
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Moving Data to Auxiliary Memory 


In your assembly-language programs, you can use the built-in subroutine 
named AUXMOVE to copy blocks of data from main memory to auxiliary 
memory or from auxiliary memory to main memory. Before calling this 
routine, you must put the data addresses into byte pairs in page zero and set 
the carry bit to select the direction of the move—main to auxiliary or 
auxiliary to main. 


Don't try to use AUXMOVE to copy data in page zero or page one (the 
65C02 stack) or in the bank-switched memory ($D000-$FFFF). 
AUXMOVE uses page zero all during the copy, so it can’t handle moves in 
the memory space switched by ALTZP. 


The pairs of bytes you use for passing addresses to this subroutine are 
called Al, A2, and A4, and they are used for parameter passing by several of 
the Apple Ile’s built-in routines. The addresses of these byte pairs are 
shown in Table 4-9. 


Table 4-9. Parameters for AUXMOVE Routine 
Note: The X, Y, and A registers are preserved by AUXMOVE. 


Name Location Parameter Passed 
Carry 1 = Move from main to auxiliary memory 
0 = Move from auxiliary to main memory 
A1L $3C Source starting address, low-order byte 
AlH $38D Source starting address, high-order byte 
A2L $3E Source ending address, low-order byte 
A2H $3F Source ending address, high-order byte 
A4L $42 Destination starting address, low-order byte 
A4H $43 Destination starting address, high-order byte 


Put the addresses of the first and last bytes of the block of memory you 
want to copy into Al and A2. Put the starting address of the block of 
memory you want to copy the data to into A4. 


The AUXMOVE routine uses the carry bit to select the direction to copy 
the data. To copy data from main memory to auxiliary memory, set the 
carry bit; to copy data from auxiliary memory to main memory, clear the 
carry bit. 
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When you make the subroutine call to AUXMOVE, the subroutine copies the 
block of data as specified by the A byte pairs and the carry bit. When it is 
finished, the accumulator and the X and Y registers are just as they were 
when you called AUXMOVE. 


Transferring Control to Auxiliary Memory 


You can use the built-in routine named XFER to transfer control to and from 
program segments in auxiliary memory. You must set up three parameters 
before using XFER: the address of the routine you are transferring to, the 
direction of the transfer (main to auxiliary or auxiliary to main), and which 
page zero and stack you want to use. 


Table 4-10. Parameters for XFER Routine 
Note: The X, Y, andA parameters are preserved by XFER. 


Name or 
Location Parameter Passed 
Carry 1 = Transfer from main to auxiliary memory 
( = Transfer from auxiliary to main memory 
Overflow 1 = Use page zero and stack in auxiliary memory 
() = Use page zero and stack in main memory 
$038ED Program starting address, low-order byte 
$03EE Program starting address, high-order byte 


Put the transfer address into the two bytes at locations $03ED and $03EE, 
with the low-order byte first, as usual. The direction of the transfer is 
controlled by the carry bit: set the carry bit to transfer to a program in 
auxiliary memory; clear the carry bit to transfer to a program in main 
memory. Use the overflow bit to select which page zero and stack you want 
to use: clear the overflow bit to use the main memory; set the overflow bit to 
use the auxiliary memory. 


After you have set up the parameters, pass control to the XFER routine by a 
jump instruction, rather than a subroutine call. XFER saves the 
accumulator and the transfer address on the current stack, then sets up the 
soft switches for the parameters you have selected and jumps to the new 
program. 
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It is the programmer's responsibility to save the current stack pointer at 
$0100 in main memory and the alternate stack pointer at $0101 in 
auxiliary memory before calling XFER and to restore them after regaining 
control. Failure to do so will cause program errors. 


The Reset Routine 


For information about the I/O links, see the 
section “Changing the Standard I/O Links” 
in Chapter 6. 


For more information about peripheral-card 
ROM, see the section ‘‘Peripheral-Card ROM 
Space” in Chapter 6. 


To put the Apple Ile into a known state when it has just been turned on or 
after a program has malfunctioned, there is a procedure called the reset 
routine. The reset routine is built into the Apple Ile’s firmware, and it is 
initiated any time you turn power on or press while holding down 
(CONTROL ]. The reset routine puts the Apple Ile into its normal operating 
mode and restarts the resident program. 


When you initiate a reset, hardware in the Apple Ile sets the 
memory-controlling soft switches to normal: main board RAM and ROM are 
enabled, and, if there is an 80-column text card in the auxiliary slot, 
expansion slot 3 is allocated to the built-in 80-column firmware. Auxiliary 
RAM is disabled and the bank-switched memory space is set up to read from 
ROM and write to RAM, using the second bank at $D000. 


The reset routine sets the display-controlling soft switches to display 
4(-column text Page 1 using the primary character set, then sets the 
window equal to the full 40-column display, puts the cursor at the bottom of 
the screen, and sets the display format to normal. 


The reset routine sets the keyboard and display as the standard input and 
output devices by loading the standard I/O links. It turns annunciators 0 
and 1 off and annunciators 2 and 8 on, clears the keyboard strobe, turns off 
any active peripheral-card ROM and outputs a bell (tone). 


The Apple Ile has three types of reset: power-on reset, also called cold-start 
reset; warm-start reset; and forced cold-start reset. The procedure described 
above is the same for any type of reset. What happens next depends on the 
reset vector. The reset routine checks the reset vector to determine whether 
it is valid or not, as described later in this chapter in the section “The Reset 
Vector.” If the reset was caused by turning the power on, the vector will not 
be valid, and the reset routine will perform the cold-start procedure. If the 
vector is valid, the routine will perform the warm-start procedure. 


The Reset Routine Q] 


For more information about ProDOS and 
the startup procedure, see the ProDOS 
Technical Reference Manual. 


important! 
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The Cold-Start Procedure 


If the reset vector is not valid, either the Apple Ile has just been turned on 
or something has caused memory contents to be changed. The reset routine 
clears the display and puts the string Apple //e (Apple 1{ onan 
original Ile) at the top of the display. It loads the reset vector and the 
validity-check byte as described below, then starts checking the expansion 
slots to see if there is a disk drive controller card in one of them, starting 
with slot 7 and working down. 


If it finds a controller card, it initiates the startup (bootstrap) routine that 
resides in the controller card’s firmware. The startup routine then loads 
DOS or ProDOS from the disk in drive 1. When the operating system has 
been loaded, it displays other messages on the screen. If there is no disk in 
the disk drive, the drive motor just keeps spinning until you press 

RESET |. 


If the reset routine doesn’t find a controller card, or if you press 

again before the startup procedure has been completed, 
the reset routine will continue without using the disk, and pass control to 
the built-in Applesoft interpreter. 


The Warm-Start Procedure 

———SSS————————EESSSSSS_———_SS Aaa 

Whenever you press when the Apple Ile has already 
completed a cold-start reset, the reset vector is still valid and it is not 
necessary to reinitialize the entire system. The reset routine simply uses the 
vector to transfer control to the resident program, which is normally the 
built-in Applesoft interpreter. If the resident program is indeed Applesoft, 
your Applesoft program and variables are still intact. If you are using DOS, 
it is the resident program and it restarts either Applesoft or Integer BASIC, 


whichever you were using when you pressed [CONTROL H RESET |. 


A program in bank-switched RAM cannot use the reset vector to regain 
control after a reset, because the Apple Ile hardware enables ROM in the 
bank-switched memory space. If you are using Integer BASIC, which is in 
the bank-switched RAM, you are also using DOS, and it is DOS that 
controls the reset vector and restarts BASIC. 
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If a program has loaded the reset vector to point to the beginning of the 
program, as described in the next section, pressing 
causes a warm-start reset that uses the vector to transfer control to that 
program. If you want to stop such a program without turning the power off 
and on, you can force a cold-start reset by holding down (G] and (CONTROL }, 
then pressing and releasing [RESET }. 


Unconditional Restart: When you want to stop a program 
unconditionally—for example, to start up the Apple Ile with some other 
program—you should use the forced cold-start reset, 
[G}{CONTROL }{ RESET ], instead of turning the power off and on. 


Whenever you press [CONTROL }{ RESET ], firmware in the Apple Ile always 
checks to see whether either Apple key is down. If the (é] key is down, with 
or without the (G) key, the firmware performs the self-test described later in 
this chapter. If only the [G] key is down, the firmware starts a forced 
cold-start reset. First, it destroys the program or data in memory by writing 
two bytes of arbitrary. data into each page of main RAM. The two bytes that 
get written over in page 3 are the ones that contain the reset vector. The 
reset routine then performs a normal cold-start reset. 


The Reset Vector 


=a ee eee ea 

When you reset the Apple Ile, the reset routine transfers control to the 
resident program by means of an address stored in page 3 of main RAM. 
This address is called a vector because it directs program control to a 
specified destination. There are several other vector addresses stored in 
page 3, as shown in Table 4-11, including the interrupt vectors described in 
the section “Interrupts on the Enhanced Apple Ile” in Chapter 6, and the 
ProDOS and DOS vectors described in the ProDOS Technical Reference 
Manual and the Apple IT DOS Programmer's Manual. 


The cold-start reset routine stores the starting address of the built-in 
Applesoft interpreter, low-order byte first, in the reset vector address at 
locations 1010 and 1011 (hexadecimal $03F2 and $03F3). It then stores 4 
validity-check byte, also called the power-up byte, at location 1012 
(hexadecimal $03F4). The validity-check byte is computed by performing 
an exclusive-OR of the second byte of the vector with the constant 165 
(hexadecimal $A5). Each time you reset the Apple Ile, the reset routine uses 
this byte to determine whether the reset vector is still valid. 


The Reset Routine 93 


See “The User’s Interrupt Handler at $3FE” 
in Chapter 6. 
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You can change the reset vector so that the reset routine will transfer 
control to your program instead of to the Applesoft interpreter. For this to 
work, you must also change the validity-check byte to the exclusive-OR of 
the high-order byte of your new reset vector with the constant 165 ($A5). If 
you fail to do this, then the next time you reset the Apple Ile, the reset 
routine will determine that the reset vector is invalid and perform a 
cold-start reset, eventually transferring control to the disk startup routine or 
to Applesoft. 


The reset routine has a subroutine that generates the validity-check byte 
for the current reset vector. You can use this subroutine by doing a 
subroutine call to location -1169 (hexadecimal $FB6F). When your program 
finishes, it can return the Apple Ile to normal operation by restoring the 
original reset vector and again calling the subroutine to fix up the 
validity-check byte. 


Table 4-11. Page 3 Vectors 


Vector 

Address Vector Function 

$3F0 Address of the subroutine that handles BRK requests (normally 
$3F1 $59, $FA). 

$3F2 Reset vector (see text). 

$3F3 

$3F4 Power-up byte (see text). 

$3F5 Jump instruction to the subroutine that handles Applesoft & 
$3F6 commands (normally $4C, $58, $FF). 

$3F7 

$3F8 Jump instruction to the subroutine that handles user 

$3F9 (CONTROL }{y] commands. 

$3FA 

$3FB Jump instruction to the subroutine that handles non-rmaskable 
$3FC interrupts. 

$3FD 

$3FE Interrupt vector (address of the subroutine that handLes 

$3FF interrupt requests). 
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Automatic Self-Test 
SSS See as ee ee) 


If you reset the Apple Ile by holding down (#6) and while 
pressing and releasing (RESET |, the reset routine will start running the 
built-in self-test. Successfully running this test assures you that the 
Apple Ile is operational. 


The self-test routine tests the Apple Ile’s programmable memory by 
writing and then reading it. All programs and data in programmable 
memory when you run the self-test are destroyed. 


The self-test takes several seconds to run. The screen will display some 
patterns in low resolution mode which will change rapidly just before the 
self-test finishes. If the test finishes normally, the Apple Ile displays 
System OK and waits for you to restart the system. 


If you have been running a program, some soft switches might be on when 
you run the self-test. If this happens, the self-test will display a message 
such as 


IOU FLAG ES: 1 


Turn the power off for several seconds, then turn it back on and run the 
self-test again. If it still fails, there is really something wrong; to get it 
corrected, contact your authorized Apple dealer for service. 
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The starting addresses for all of the 
standard subroutines are listed in 
Appendix B. 


The System Monitor is a set of subroutines in the Apple Ile firmware. The 
Monitor provides a standard interface to the built-in I/O devices described 
in Chapter 2. The I/O subroutines described in Chapter 3 are part of the 
System Monitor. 


ProDOS, DOS 3.3, and the BASIC interpreters use these subroutines by 
direct calls to their starting locations, as described for the I/O subroutines 
in Chapter 3. 


If you wish, you can call the standard subroutines from your programs in 
the same fashion. 


You can perform most of the Monitor functions directly from the Keyboard. 
This chapter tells you how to use the Monitor to 


O look at one or more memory locations 
oO change the contents of any location 


O write programs in machine language to be executed directly by the 
Apple Ile’s microprocessor 

o save blocks of data and programs onto cassette tape and read them back 

in again 

move and compare blocks of memory 

search for data bytes and ASCII characters in memory 

invoke other programs from the Monitor 

invoke the Mini-Assembler. 


O O a QO 


Invoking the Monitor 
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The System Monitor starts at memory location $FF69 (decimal 65385 

or -l51). To invoke the Monitor, you make a CALL statement to thas location 
from the keyboard or from a BASIC program. When the Monitor is running, 
its prompting character, an asterisk (*), appears on the left side off the 
display screen, followed by a blinking cursor. 


To use the Monitor, you type commands at the keyboard. When you have 
finished using the Monitor, you return to the BASIC language you. were 
previously using by pressing [CONTROL }{ RESET |, by pressing 


then [RETURN ], or by typing 3D9G, which execute s the 
resident program—usually Applesoft—whose address is stored in a jump 


instruction at location $3D0. 


Chapter 5: Using the Monitor 


Syntax of Monitor Commands 


See “Summary of Monitor Commands” at 
the end of this chapter. 


To give acommand to the Monitor, you type a line on the keyboard, then 
press [RETURN }. The Monitor accepts the line using the standard I/O 
subroutine GETLN, described in Chapter 3. A Monitor command can be up 
to 255 characters in length, ending with a carriage return. 


A Monitor command can include three kinds of information: addresses, data 
values, and command characters. You type addresses and data values in 
hexadecimal notation. Hexadecimal notation uses the ten decimal digits 
(0-9) and the first six letters (A-F) to represent the sixteen values from 

(0 to 15. A pair of hexadecimal digits represent values from 0 to 255, 
corresponding to a byte, and a group of four hexadecimal digits can 
represent values from 0 to 65,536, corresponding to a word. Any address in 
the Apple Ile can be represented by four hexadecimal digits. 


When the command you type calls for an address, the Monitor accepts any 
group of hexadecimal digits. If there are fewer than four digits in the group, 
it adds leading zeros; if there are more than four hexadecimal digits, the 
Monitor uses only the last four digits. It follows a similar procedure when 
the command syntax calls for two-digit data values. 


Each command you type consists of one command character, usually the 
first letter of the command name. When the command is a letter, it can be 
either uppercase or lowercase. The Monitor recognizes 28 different 
command characters. Some of them are punctuation marks, some are 
letters, and some are control characters. 


Note: Although the Monitor recognizes and interprets control characters 
typed on an input line, they do not appear on the screen. 


This chapter contains many examples of the use of Monitor commands. In 
the examples, the commands and values you type are shown in a normal 
typeface and the responses of the Monitor are in a computer typeface. Of 
course, when you perform the examples, all of the characters that appear 
on the display screen will be in the same typeface. Some of the data values 
displayed by your Apple Ile may differ from the values printed in these 
examples, because they are variables stored in programmable memory. 
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Monitor Memory Commands 


When you use the Monitor to examine and change the contents of memory, 
it keeps track of the address of the last location whose value you inquired 

about and the address of the location that is next to have its value changed. 
These are called the last opened location and the next changeable location. 


Examining Memory Contents 
a SC ees | 


When you type the address of a memory location and press [RETURN ], the 
Monitor responds with the address you typed, a dash, a space, and the value 
stored at that location, like this: 


* E000 
EG80- 20 
#33 
8033- AA 


# 


Each time the Monitor displays the value stored at a location, it saves the 
address of that location as the last opened location and as the next 
changeable location. 


Memory Dump 


A 

When you type a period (.) followed by an address, and then press 
(RETURN ], the Monitor displays a memory dump: the data values stored at 
all the memory locations from the one following the last opened | ocation to 
the location whose address you typed following the period. The Monitor 
saves the last location displayed as both the last opened location and the 
next changeable location. In these examples, the amount of data displayed 
by the Monitor depends on how much larger than the last opened location 
the address after the period is. 
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*20 
8020- 00 


* 2B 
8821- 28 66 18 BOF BC 68 BB 
8828- ASB 86 DB B87 


*300 
8388- 99 


* 315 

6301- BS 66 88 BA BA BA 99 
6368- 68 68 C8 D® F4 AGB 2B AD 
8318- 69 8S 27 AD CC 63 


* 32A 

8316- 85 41 

6318- 84 48 BA 4A 4A 4A 4A 89 
6328- CHO 8S 3F AID SD 8S 3E 28 
8328- 43 863 20 


# 


When the Monitor performs a memory dump, it starts at the location 
immediately following the last opened location and displays that address 
and the data value stored there. It then displays the values of successive 
locations up to and including the location whose address you typed, but 
only up to eight values on a line. When it reaches a location whose address 
is a multiple of eight—that is, one that ends with an 8 or a 0—it displays 
that address as the beginning of a new line, then continues displaying more 
values. 


After the Monitor has displayed the value at the location whose address you 
specified in the command, it stops the memory dump and sets that location 
as both the last opened location and the next changeable location. If the 
address specified on the input line is less than the address of the last 
opened location, the Monitor displays only the address and value of the 
location following the last opened location. 
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You can combine the two commands, opening a location and dum ping 
memory, by simply concatenating them: type the first address, a period, and 
the second address. This combination of two addresses separated by a 
period is called a memory range. 


*300.32F 

§83606- 99 BS 88 868 BA BA BA 99 
6368- 86 868 C8 DB F4 AG 2B AY 
6318- 69 85 27 AD CC 83 85 41 
§8318- 84 468 BA 4A 4A 4A 4A B89 
8328- C8 8S 3F AS SD 85S 3E 28 
8328- 43 63 28 46 O93 AS 3D 4D 


*30.40 

8630- AA 68 FF AA BS C2 B65 Ce 
8838- 1B FD D# 83 3C 68 48 BB 
8648- 38 


*£015.E025 

E@1G6- 4C ED FD 

E#18- AQ 28 CS 24 BB BC AQ BD 
E@20- AB 87 28 ED FD AQ 


+ 


Pressing by itself causes the Monitor to display one line of a 
memory dump; that is, a memory dump from the location following the last 
opened location to the next multiple-of-eight boundary. The Monitor saves 
the address of the last location displayed as the last opened location and the 
next changeable location. 


*0 
880S- 88 


*| RETURN 
86 88 


*| RETURN 
6808- 66 68 08 66 OB 8B B88 8B 


*32 
8832- FF 


*LRETURN 
AA 88 C2 85 C2 


*LRETURN | 
6038- 1B FD D@ 63 3C 68 3F B28 


# 
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Changing Memory Contents 

FF eR i eo ee a ee eee) 
The previous section showed you how to display the values stored in the 
Apple Ile’s memory; this section shows you how to change those values. 
You can change any location in RAM—programmable memory—and you 
can also change the soft switches and output devices by changing the 
locations assigned to them. 


AWarning Use these commands carefully. If you change the zero-page locations 
used by Applesoft, ProDOS, or DOS, you may lose programs or data stored 
in memory. 


Changing One Byte 
SS SS eee 


The previous commands keep track of the next changeable location; these 
commands make use of it. In the next example, you open location 0, then 
type a colon (:) followed by a value. 


*() 


O6008- 96 
*:5F 


The contents of the next changeable location have just been changed to the 
value you typed, as you can see by examining that location: 


*() 
8000- SF 


# 


You can also combine opening and changing into one operation by typing an 
address followed by a colon and a value. In the example, you type the 
address again to verify the change. 


#302:42 
#302 
6382- 42 


# 


When you change the contents of a location, the value that was contained 
in that location disappears, never to be seen again. The new value will 
remain until you replace it with another value. 
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Changing Consecutive Locations 


You don’t have to type a separate command with an address, a colon, a 
value, and for each location you want to change. You can change 
the values of up to 85 consecutive locations at a time (or even more, if you 
omit leading zeros from the values) by typing only the initial address and 
colon followed by all the values separated by spaces, and ending with 
(RETURN ]. The Monitor will duly store the consecutive values in 
consecutive locations, starting at the location whose address you typed. 
After it has processed the string of values, it takes the location following the 
last changed location as the next changeable location. Thus, you can 
continue changing consecutive locations without typing an address on the 
next input line by typing another colon and more values. In these examples, 
you first change some locations, then examine them to verify the changes. 


*300:69 01 20 ED FD 4003 
*300 
8380- 69 


*[RETURN 
01 20 ED FD 4C a8 O63 


*10:0128 
#4567 
#10.17 


6010- 88 81 82 83 B84 8S O86 B7 


# 


ASCIl Input Mode 


—————— eee ered 

The enhanced Apple Ile has an ASCII input mode that lets you enter ASCII 
characters just as you can their hexadecimal ASCII equivalents bry 
preceding the literal character with an apostrophe (’). This means that ’A is 
the same as $C1 and ’Bis the same as $C2 to the Monitor. The ASCII value 
for any character following an apostrophe is used by the Monitor. 
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Important! 


Original lle 


Each character to be placed in memory should be delimited by a leading 
apostrophe (’) and a trailing space. The only exception to this rule is that 
the last character in the line is followed with a return character instead of a 
space. The following example would enter the string “Hooray for sushi!” at 
$0300 in memory. 


*800:'H ’o’o’r’a’y’ 'f’o’r’ ’s’u’s’h'i’! 


ASCII input mode sets the high bit of the code for a character that you 
enter. So ’A will equal $C1, not $41. 


| The original Apple Ile does not have an ASCII input mode. 


Moving Data in Memory 
Se ae EE ei 8 et ein 


You can copy a block of data stored in a range of memory locations from one 
area in memory to another by using the Monitor’s MOVE command. To 
move a range of memory, you must tell the Monitor both where the data is 
now situated in memory (the source locations) and where you want the 
copy to go (the destination locations). You give this information to the 
Monitor by means of three addresses: the address of the first location in the 
destination and the addresses of the first and last locations in the source. 
You specify the starting and ending addresses of the source range by 
separating them with a period. You separate the destination address from 
the range addresses with a less-than character (<_), which you may think 
of as an arrow pointing in the direction of the move. Finally, you tell the 
Monitor that this is a MOVE command by typing the letter M (in either 
lowercase or uppercase). The format of the complete MOVE command looks 
like this: 


\destination| < jstart} . jend} M 


When you type the actual command, the words in braces should be replaced 
by hexadecimal addresses, and the braces and spaces should be omitted. 
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See the section “Special Tricks With the 
Monitor” later in this chapter for an 
interesting application of this feature. 
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Here are some examples of Monitor commands, including some memory 
moves. First, you examine the values stored in one range of memory, then 
store several values in another range of memory; the actual MOV E 
commands end with the letter M. 


*(0.F 


G@6088- SF 68 85 87 B88 86 86 6B 
668608- 669 66 868 86 68 66 88 68 


*300:A9 8D 20 ED FD AQ 45 20 DA FD 4C 00 03 
*300.30C 


83668- AS BD 26 ED FD AQ 45 28 
6368- DA FD 4C 68 63 


*()<300.300M 
*().C 


66080- AY 8D 26 ED FD AS 45 28 
8868- DA FD 4C 68 63 


*310<8.AM 
*310.312 

8319- DA FD 4C 
*2<7.9M 

*0.C 


6688- AO 8D 26 DA FD AS 45 28 
6688- DA FD 4C 88 83 


# 


The Monitor moves a copy of the data stored in the source range of locations 
to the destination locations. The values in the source range are left 
undisturbed. The Monitor remembers the last location in the source range 
as the last opened location, and the first location in the source range as the 
next changeable location. If the second address in the source range 
specification is less than the first, then only one value (that of the first 
location in the range) will be moved. 


If the destination address of the MOVE command is inside the source range 
of addresses, then strange (and sometimes wonderful) things happen: the 
locations between the beginning of the source range and the destination 
address are treated as a sub-range and the values in this sub-range are 
replicated throughout the source range. 
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See the section “Special Tricks With the 
Monitor” later in this chapter. 


Comparing Data in Memory 


arr ee ee eer ee 

You can use the VERIFY command to compare two ranges of memory using 
the same format you use to move a range of memory from one place to 
another. In fact, the VERIFY command can be used immediately after a 
MOVE command to make sure that the move was successful. 


The VERIFY command, like the MOVE command, needs a range and a 
destination. The syntax of the VERIFY command is 


{destination} < {start} . {end} V 


The Monitor compares the values in the source locations with the values in 
the locations beginning at the destination address. If any values don’t 
match, the Monitor displays the address at which the discrepancy was 
found and the two values that differ. In the example, you store data values 
in the range of locations from 0 to $D, copy them to locations starting at 
$300 with the MOVE command, and then compare them using the VERIFY 
command. When you use the VERIFY command after you change the value 
at location 6 to $E4, it detects the change. 


*0:D7 F2 E9 F4 F4 E5 EE AO E2 F9 AO C3 C4 C5 
*300<0.DM 

*300<0.DV 

*6:E4 

*300<0.DV 

8BBG-E4 CEE) 


# 


If the VERIFY command finds a discrepancy, it displays the address of the 
location in the source range whose value differs from its counterpart in the 
destination range. If there is no discrepancy, VERIFY displays nothing. The 
VERIFY command leaves the values in both ranges unchanged. The last 
opened location is the last location in the source range, and the next 
changeable location is the first location in the source range, just as in the 
MOVE command. If the ending address of the range is less than the starting 
address, the values of only the first locations in the ranges will be 
compared. Like the MOVE command, the VERIFY command also does 
unusual things if the destination address is within the source range. 
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Searching for Bytes in Memory 
ea yee ae es Oe ee el 


The SEARCH command lets you search for one or two bytes (either 
hexadecimal values or ASCII characters) in a range of memory. You must 
type in the ASCII string (or hexadecimal number or numbers) in reverse of 
the order that they appear in memory. Think of the SEARCH command as 
looking for items in a last-in, first-out queue. 


The syntax of the SEARCH command is 
{value or ASCII} <|start}.end/S 


If the byte (or two byte sequence) that you specify is in the specified 
memory range, the Monitor will return with a list of the addresses where 
that byte (or byte sequence) occurs. If the byte (or byte sequence) is not in 
the range, the Monitor just displays the prompt. 


The following example looks for the character string ZO in memory 
between $0300 and $03FF. 


*O’'L<300.3FFS 
High Bit Set: Remember that ASCII input mode sets the high-order bit of 
each character that you enter. 

The next example searches for the two-byte sequence $FF11. 

*11FF<3800.3FFS 


You can't search for a two-byte sequence with a high byte of 0. The Monitor 
ignores the high byte and searches for the low byte only. The sequence 
QOFF is seen by the Monitor SEARCH command as FF. 


The Monitor in the original Apple Ile does not recognize the SEARCH 
command. 


Examining and Changing Registers 


Na a PE ae eR re | 
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The microprocessor’s register contents change continuously whenever the 
Apple Ile is running any sort of program, such as the Monitor. The Monitor 
lets you see what the register contents were when you invoked the Monitor 
or a program that you were debugging stopped at a break (BRK). The 
Monitor also lets you set 65C02 register values before you execute a 
program with the GO command. 
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When you call the Monitor, it stores the contents of the microprocessor’s 
registers in memory. The registers are stored in the order A, X, Y, P 
(processor status register), and S (stack pointer), starting at location $45 
(decimal 69). When you give the Monitor a GO command, the Monitor loads 
the registers fromm these five locations before it executes the first instruction 
in your program. 


Pressing and then invokes the Monitor’s EXAMINE 
command, which displays the stored register values and sets the location 
containing the contents of the A register as the next changeable location. 
After using the EXAMINE command, you can change the values in these 
locations by typing a colon and then typing the new values separated by 
spaces. In the following example, you display the registers, change the first 
two, and then display them again to verify the change. 


*| CONTROL } E | 


A=@A X=FF Y=D8 P=#B9 S=F8 
*-BO 02 


*LCONTROL }{ E_ 
A=B@# X=62 Y=D8 P=BO S=F8 


* 


Monitor Cassette Tape Commands 


The Apple Ile has two jacks for connecting an audio cassette tape recorder. 
With a recorder connected, you can use the Monitor commands described 
later in this section to save the contents of a range of memory onto a 
standard cassette and recall it for later use. 


Saving Data on Tape 
a ee eS 


The Monitor's WRITE command saves the contents of up to 65,536 memory 
locations on cassette tape. To save a range of memory on tape, give the 
Monitor the starting and ending addresses of the range, followed by the 
letter W (for WRITE), like this: 


start} . jend| W 
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Don’t press yet: first, put the tape recorder in record mode and let 
the tape run for a second, then press [RETURN }. The Monitor will write a 
ten-second tone onto the tape and then write the data. The tone acts as a 
leader: later, when the Monitor reads the tape, the leader enables the 
Monitor to get in step with the signal from the tape. When the Monitor is 
finished writing the range you specified, it will sound a bell (beep) and 
display a prompt. You should rewind the tape and label it with the memory 
range that’s on the tape and what it’s supposed to be. 


Here’s a small example you can save and use later to try out the READ 
command. Remember that you must start the cassette recorder in record 
mode before you press after typing the WRITE command. 


*(:FF FF AD 30 CO 88 D0 04 C6 01 FO 08 CA 
DO F6 A6 00 4C 02 00 60 


*().14 


BOO8- FF FF AD 36 C8 88 DB 64 
8608- C6 61 FH 88 CA DOB FE AG 
6019- 66 4C B82 88 6B 


*0.14W 


It takes about 35 seconds total to save the values of 4,096 memory locations 
preceded by the ten-second leader onto tape. This works out to an average 
data transfer rate of about 1,350 bits per second. 


The WRITE command writes one extra value on the tape after it has 
written the values in the memory range. This extra value is the checksum, 
which is the eight-bit partial sum of all values in the range. When the 
Monitor reads the tape, it uses this value to determine if the data has been 
written and read correctly. (See the next section. ) 


Reading Data From Tape 
pe ee ee eee 


Once you've saved a memory range onto tape with the Monitor’s WRITE 
command, you can read that memory range back into the computer by 
using the Monitor's READ command. The data values you’ve stored on the 
tape need not be read back into the same memory range from whence they 
came; you can tell the Monitor to put those values into any memory range in 
the computer’s memory, provided that it’s the same size as the range you 
saved. 
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The format of the READ command is the same as that of the WRITE 
command, except that the command letter is R: 


start} . {end} R 


Once again, after typing the command, don’t press [RETURN ]}. Instead, start 
the tape recorder in play mode and wait a few seconds. Although the 
WRITE command puts a ten-second leader tone on the beginning of the 
tape, the READ command needs only three seconds of this leader to lock on 
to the signal from the tape. You should let a few seconds of tape go by before 
you press to allow the tape recorder’s output to settle down toa 
steady tone. 


This example has two parts. First, you set a range of memory to zero, verify 
the contents of memory, and then type the READ command, but don’t press 
[RETURN }. 


*0:000000000000000000000 
*(.14 


8600- 686 66 BH 66 B68 B86 BB OB 
8088- 66 66 BH 668 B86 BB BH BB 
6018- 68 66 BH BH 68 


*().14R 


Now start the cassette running in play mode, wait a few seconds, and press 
(RETURN }. After the Monitor sounds the bell (beep) and displays the prompt, 
examine the range of memory to see that the values from the tape were 
read correctly: 


*(.14 


OO06- FF FF AD 38 CB 88 DO 84 
86088- C6 61 FB B88 CA DB FE AG 
6618- 66 4C B2 B88 6B 


# 


After the Monitor has read all the data values on the tape, it reads the 
checksum value. It computes the checksum on the data it read and 
compares it to the checksum from the tape. If the two checksums differ, the 
Monitor sends a beep to the speaker and displays ERR. This warns you that 
there was a problem reading the tape and that the values stored in memory 
aren't the values that were recorded on the tape. If the two checksums 
match, the Monitor will just send out a beep and display a prompt. 
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Miscellaneous Monitor Commands 

I S892 SSR eRe 8 a cE i Pe me TE | 
These Monitor commands enable you to change the video display format 
from normal to inverse and back, and to assign input and output to 
accessories in expansion slots. 


Inverse and Normal Display 
SSS SS Se eee 


You can control the setting of the inverse-normal mask location used by the 
COUT subroutine (described in Chapter 3) from the Monitor so that all of 
the Monitor’s output will be in inverse format. The INVERSE command, I, 
sets the mask such that all subsequent inputs and outputs are displayed in 
inverse format. To switch the Monitor's output back to normal format, use 
the NORMAL command, N. 


*0.F 


8600- BA OB BC OD BE BF DB B4 
6O888- C6 81 FB B88 CA DO FE AG 
*] 


*().F 


8O000- BA 8B OC BD BE OF DB B4 
8808- C6 61 FH 868 CA DO FE AG 
*N 


*().F 


86600- BA 8B BC BD BE BOF DB 84 
86808- C6 81 FH 868 CA DB FE AG 


% 


Back to BASIC 


SSS SS a 

Use the BASIC command, [CONTROL }{B], to leave the Monitor and enter the 
BASIC that was active when you entered the Monitor. Normally, this is 
Applesoft BASIC, unless you deliberately switched to Integer BASIC. Any 
program or variables that you had previously in BASIC will be los t. If you 
want to reenter BASIC with your previous program and variables intact, use 
the CONTINUE BASIC command, (CONTROL } C]. 


liZ Chapter 5: Using the Monitor 


AWanrning 


If you are using DOS 3.8 or ProDOS, press or type 
3D8G 


to return to the language you were using, with your program and variables 
intact. 


That's a Number Not a Letter: If you use 8D0G, make sure that the 
third character you type is a zero, not a letter O. The letter G is the 
Monitor’s GO command, described in the section “Machine-Language 
Programs” later in this chapter. 


Redirecting Input and Output 
Se ee 


The PRINTER command, activated by a[CONTROL}{P}], diverts all output 
normally destined for the screen to an interface card in a specified 
expansion slot, from 1 to 7. There must be an interface card in the specified 
slot, or you will lose control of the computer and your program and variables 
may be lost. The format of the command is 


{slot number} (P 


A PRINTER command to slot number 0 will switch the stream of output 
characters back to the Apple Ile’s video display. 


Don’t give the PRINTER command with slot number 0 to deactivate the 
80-column firmware, even though you used this command to activate it in 
slot 3. The command works, but it just disconnects the firmware, leaving 
some of the soft switches set for 80-column display. 


In much the same way that the PRINTER command switches the output 
stream, the KEYBOARD command substitutes the interface card in a 
specified expansion slot for the Apple IIe’s normal input device, the 
keyboard. The format for the KEYBOARD command is 


{slot number} K] 


A slot number of 0 for the KEYBOARD command directs the Monitor to 
accept input from the Apple Ile’s built-in keyboard. 


The PRINTER and KEYBOARD commands are the exact equivalents of the 
BASIC commands PR# and IN#. 
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Hexadecimal Arithmetic 
SSS ee ee ea ey 


The Monitor will also perform one-byte hexadecimal addition and 
subtraction. Just type a line in one of these formats: 


pa + |value} 
\value; - |value; 


The Apple Ile performs the arithmetic and displays the result, as shown in 
these examples: 


#20413 
=33 
#4A-C 
=3E 
*PR+4 
=83 
#3-4 
=FF 


Special Tricks With the Monitor 

CNET nee OOOO 
This section describes some more complex ways of using the Monitor 
commands. 


Multiple Commands 
eS ee one 


You can put as many Monitor commands on a single line as you like, as long 
as you separate them with spaces and the total number of characters in the 
line is less than 254. Adjacent single-letter commands such as L, S, I, and N 
need not be separated by spaces. 


You can freely intermix all of the commands except the STORE (: ) 
command. Since the Monitor takes all values following a colon and places 
them in consecutive memory locations, the last value ina STORE must be 
followed by a letter command before another address is encountered. You 
can use the NORMAL command as the required letter command in such 
cases; it usually has no effect and can be used anywhere. 
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In the following example, you display a range of memory, change it, and 
display it again, all with one line of commands. 


* 300.307 300:18 69 1 N 300.302 


8308- 66 06 6H 08 68 66 88 BB 
8300- 18 69 61 


+ 


If the Monitor encounters a character in the input line that it does not 
recognize as either a hexadecimal digit or a valid command character, it 
executes all the commands on the input line up to that character, then 
grinds to a halt with a noisy beep and ignores the remainder of the input 
line. 


Filling Memory 
SS aa ee 


The MOVE command can be used to replicate a pattern of values 
throughout a range of memory. To do this, first store the pattern in the first 
locations in the range: 


*300:11 22 33 


# 


Remember the number of values in the pattern: in this case, it is 3. Use the 
number to compute addresses for the MOVE command, like this: 


istart+number! < !start! . 'end-number! M 
‘i [+ | I 


This MOVE command will first replicate the pattern at the locations 
immediately following the original pattern, then replicate that pattern 
following itself, and so on until it fills the entire range. 


*303<00.32DM 
*300.32F 


§6388- 11 22 33 11 22 33 11 22 
§6388- 33 11 22 33 11 22 33 11 
6318- 22 33 11 22 33 11 22 33 
§8318- 11 22 33 11 22 33 11 22 
§8320- 33 11 22 33 11 22 33 11 
8328- 22 33 11 22 33 11 22 33 


# 
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You can do a similar trick with the VERIFY command to check whether a 
pattern repeats itself through memory. This is especially useful to verify 
that a given range of memory locations all contain the same value. In this 
example, you first fill the memory range from $0300 to $0820 with zeros and 
verify it, then change one location and verify again, to see the VERIFY 
command detect the discrepancy: 


*300:0 

#301 <300.31FM 
#301<300.31FV 
*304:02 
*301<300.31FV 


8363-68 (82) 
6384-62 (66) 


# 


Repeating Commands 
SS ee 


You can create a command line that repeats one or more commands over 
and over. You do this by beginning the part of the command line that you 
want to repeat with a letter command, such as N, and ending it wath the 
sequence 34:n, where nis a hexadecimal number that specifies the position 
in the line of the command where you want to start repeating; for the first 
character in the line, n=0. The value for n must be followed with a space in 
order for the loop to work properly. 


This trick takes advantage of the fact that the Monitor uses an index 
register to step through the input buffer, starting at location $0200. Each 
time the Monitor executes a command, it stores the value of the index at 
location $34; when that command is finished, the Monitor reloads the index 
register with the value at location $34. By making the last comma.nd change 
the value at location $34, you change this index so that the Monitor picks up 
the next command character from an earlier point in the buffer. 
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The only way to stop a loop like this is to press [CONTROL }{ RESET }; that is 
how this example ends. 


*N 300 302 34:0 
8308- 11 
9382- 33 
6308- 11 
8302- 33 
8308- 11 
8302- 33 
O308- 11 
8382- 33 
8300- 11 
8392- 33 
8300- 11 
8302- 33 
636 


Creating Your Own Commands 


ae eee es 

The USER command, forces the Monitor to jump to memory 
location $08F8. You can put a JMP instruction there that jumps to your own 
machine-language program. Your program can then examine the Monitor’s 
registers and pointers or the input buffer itself to obtain its data. For 
example, here is a program that displays everything on the input line after 
the (CONTROL HY]. The program starts at location $0300; the command line 
that starts with $03F8 stores a jump to $0300 at location $03F8. 


*300:A4 34 BY 00 02 20 ED FD C8 C9 8D D0 F5 4C 69 FF 
* 3F8:4C 00 03 


*(CONTROL HY] THIS IS A TEST 
THIS IS A TEST 
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Machine-Language Programs 


The main reason to program in machine language is to get more speed. A 
program in machine language can run much faster than the same program 
written in high-level languages such as BASIC or Pascal, but the 
machine-language version usually takes a lot longer to write. There are 
other reasons to use machine language: you might want your program to do 
something that isn’t included in your high-level language, or you might just 
enjoy the challenge of using machine language to work directly on the bits 
and bytes. 


Boning Up on Machine Language: If you have never used machine 
language before, you'll need to learn the 65C02 instructions listed in 
Appendix A. To become proficient at programming in machine language, 
you'll have to spend some time at it and study at least one of the books on 
6502 programming listed in the bibliography. With the books and 
Appendix A, you'll have the needed information to program the 65C02. 


You can get a hexadecimal dump of your program, move it around in 
memory, or save it on tape and recall it using the commands described in 
the previous sections. The Monitor commands in this section are intended 
specifically for you to use in creating, writing, and debugging 
machine-language programs. 


Running a Program 
ee 


The Monitor command you use to start execution of your machine-language 
program is the GO command. When you type an address and the Ietter G, 
the Apple Ile starts executing machine language instructions starting at the 
specified location. If you just type the G, execution starts at the last opened 
location. The Monitor treats this program as a subroutine: it should end with 
an RTS (return from subroutine) instruction to transfer control back to the 
Monitor. 
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The word mnemonic comes from the same 
root as memory and refers to 
abbreviations that are easier to remember 
than the hexadecimal operation codes 
themselves: for examaple, for clear carry 
you write CLC instea d of $18. 


The Monitor has some special features that make it easier for you to write 
and debug machine-language programs, but before you get into that, here is 
a small machine-language program that you can run using only the simple 
Monitor commands already described. The program in the example merely 
displays the letters A through Z: you store it starting at location $0300, 
examine it to be sure you typed it correctly, then type 300G to start it 
running. 


*300:A9 C1 20 ED FD 18 69 1 C9 DB DO F6 60 
*300.80C 


6308- AS Ci 26 ED FD 18 69 61 
63608- C9 DB D# FE 68 


*300G 
ABCDEFGHI JKLMNOPQRSTUVWXYZ 


Disassembled Programs 


a Oe a 

Machine-language code in hexadecimal isn’t the easiest thing in the world 
to read and understand. To make this job a little easier, machine-language 
programs are usually written in assembly language and converted into 
machine-language code by programs called assemblers. 


Since programs that translate assembly language into machine language are 
called assemblers, a program like the Monitor’s LIST command that 
translates machine language into assembly language is called a 
disassembler. 


The Monitor’s LIST command displays machine-language code in 
assembly-language form. Instead of unformatted hexadecimal gibberish, the 
LIST command displays each instruction on a separate line, with a 
three-letter instruction name, or mnemonic, and a formatted hexadecimal 
operand. The LIST command also converts the relative addresses used in 
branch instructions to absolute addresses. 


The Monitor LIST command has the format 


location} L 
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The LIST command starts at the specified location and displays as much 
memory as it takes to make up a screenfull (20 lines) of instructions, as 
shown in the following example: 


*300L 

68366 - AS C1 LDA #$C1 
§8362- 28 ED FD JSR $F DED 
6366- 18 CLC 

6366- 69 61 ADC #361 
6368- CS DB CMP #$DB 
836A- D@ FG BNE $8362 
636C- 68 RTS 

636D- 66 BRK 

O36E- 66 BRK 

636F - 66 BRK 

6316- 66 BRK 

6311- 66 BRK 

6312- 66 BRK 

6313- 66 BRK 

6314- 66 BRK 

6316- 68 BRK 

§8316- 68 BRK 

6317- 66 BRK 

§318- 08 BRK 

§319- 68 BRK 


The first seven lines of this example are the assembly-language form of the 
program you typed in the previous example. The rest of the lines are BRK 
instructions only if this part of memory has zeros in it: other values will be 
disassembled as other instructions. 


The Monitor saves the address that you specify in the LIST command, but 
not as the last opened location used by the other commands. Instead, the 
Monitor saves this address as the program counter, which it uses only to 
point to locations within programs. Whenever the Monitor performs a LIST 
command, it sets the program counter to point to the location immediately 
following the last location displayed on the screen, so that if you type 
another LIST command it will display another screenful of instructions, 
starting where the previous display left off. 
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The Mini-Assembler 


Without an assembler, you have to write your machine language program, 
take the hexadecimal values for the opcodes and operands, and store them 
in memory using the commands covered in the previous sections. That is 
exactly what you did when you ran the previous examples. 


The Monitor includes an assembler called the Mini-Assembler that lets you 
enter machine-language programs directly from the keyboard of your Apple. 
ASCII characters can be entered in Mini-Assembler programs, exactly as 
you enter them in the Monitor. Note that the Mini-Assembler doesn’t accept 
labels; you must use actual values and addresses. 


Starting the Mini-Assembler 


To start the Mini-Assembler first invoke the Monitor by typing CALL- 151 


(RETURN ], and then from the Monitor, type ! followed by [RETURN]. The 
Monitor prompt character then changes from * to !. 


When you finish using the Mini-Assembler, press from a blank 
line to return to the Monitor. 


Restrictions 


The Mini-Assembler supports only the subset of 65C02 instructions that are 
found on the 6502. 


Before you can use the Mini-Assembler on the original Apple Ile, you have 
to be running Integer BASIC. When you start up the computer using DOS 
or either BASIC, the Apple Ile loads the Integer BASIC interpreter from 
the file named INTBASIC into the bank-switched RAM. Here’s how to 
start the Mini-Assembler on an original Apple Ile: 


1. Start Integer BASIC from DOS 3.3 by typing INT [RETURN]. 

2. After the Integer prompt character (> ) and a cursor appear, enter 
the Monitor by typing CALL - 151 [RETURN]. 

3. Now start the Mini-Assembler by typing F666G [RETURN ]. 


The Mini-Assembler [Z1 


Formats for operands are listed in Table 
5-1. 
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Using the Mini-Assembler 
—eEeEeE——EeE>EEE—————————————— 


The Mini-Assembler saves one address, that of the program counter. Before 
you start to type a program, you must set the program counter to point to 
the location where you want the Mini-Assembler to store your program. Do 
this by typing the address followed by a colon. 


After the colon, type the mnemonic for the first instruction in your program, 
followed by a space and the operand of the instruction. Now press 
(RETURN ]. The Mini-Assembler converts the line you typed into 
hexadecimal, stores it in memory beginning at the location of the program 
counter, and then disassembles it again and displays the disassermbled line. 
It then displays a prompt on the next line. 


Now the Mini-Assembler is ready to accept the second instruction in your 
program. To tell it that you want the next instruction to follow the first, 
don’t type an address or a colon: just type a space and the next instruction’s 
mnemonic and operand, then press (RETURN }. The Mini-Assembler 
assembles that line and waits for another. 


'300:LDX #02 

O300- A2 82 LDX #$02 
' LDA $0,X 

9302- BS Oo LDA $00,X 
t STA $10,X 

9304 95 18 STA $10,X 
' DEX 

9386- CA DEX 

1 STA $C0380 

9307- 8D 30 Ca STA $C 830 
1 BPL $302 

@30A- 10 F6 BPL $9302 
' BRK 

@30C- 8 BRK 


If the line you type has an error in it, the Mini-Assembler beeps loudly and 
displays a caret ( * ) under or near the offending character in the input line. 
Most common errors are the result of typographical mistakes: misspelled 
mnemonics, missing parentheses, and so forth. The Mini-Assembler also 
rejects the input line if you forget the space before or after a mnermonic or 
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include an extraneous character in a hexadecimal value or address. If the 
destination address of a branch instruction is out of the range of the branch 
(more than 127 locations distant from the address of the instruction), the 
Mini-Assembler flags this as an error. 


There are several different ways to leave the Mini-Assembler and reenter 


the Monitor. On an enhanced Apple [le only, simply press ata 
blank line. 


Original Ile | Onanoriginal Apple Ile, type the Monitor command $FF69G. 


On any Apple Ile, you can press [CONTROL }{ RESET }, which warm starts 
BASIC, then type 


CALL -151 

Your assembly-language program is now stored in memory. You can display 
it with the LIST command: 

*3001 

0308- A2 #2 LDX  #$82 
0302- BS 00 LDA $88,X 
0304- 95 18 STA $108,X 
9306- CA DEX 

0307- 8D 38 CB STA $C836 
O30A- 10 FE BPL $6302 
O30C- 68 BRK 

O38D- 00 BRK 

O30E- O80 BRK 

O30F- 98 BRK 

0310- 200 BRK 

0311- 00 BRK 

0312- 68 BRK 

9313- 68 BRK 

0314- 60 BRK 

0316- 00 BRK 

9316- 08 BRK 

0317- 60 BRK 

0318- 900 BRK 

0319- 08 BRK 


+ 
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See Appendix A for more information about 
65C02 (and 6502) instructions. 
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Mini-Assembler Instruction Formats 
SSS SaaS ae ee ee et al 


The Apple Mini-Assembler recognizes 56 mnemonics and 13 addressing 
formats. These constitute the 6502 subset of the 65C02 instruction set. The 
mnemonics are standard, as used in the Synertek Programming Manual 
(Apple part number A2L0003), but the addressing formats are somewhat 
different. Table 5-1 shows the Apple standard address-mode formats for 
6502 assembly language. 


Table 5-1. Mini-Assembler Address Formats 


Addressing Mode Format 
Accumulator . 
Implied 
Immediate #${value} 
Absolute ${address} 
Zero page ${address} 
Indexed zero page $/address!,X 
fadareaty 
Indexed absolute $/address} X 
jeden 
Relative ${address} 
Indexed indirect (${address},X) 
Indirect indexed (${address}),Y 
Absolute indirect (${address}) 


* These instructions have no operands. 


An address consists of one or more hexadecimal digits. The Mini-Assembler 
interprets addresses the same way the Monitor does: if an address has fewer 
than four digits, the Mini-Assembler adds leading zeros; if the address has 
more than four digits, then it uses only the last four. 


Dollar Signs: In this manual, dollar signs ($) in addresses signify that 
the addresses are in hexadecimal notation. They are ignored by the 
Mini-Assembler and may be omitted when typing programs. 
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There is no syntactical distinction between the absolute and zero-page 
addressing modes. If you give an instruction to the Mini-Assembler that can 
be used in both absolute and zero-page mode, the Mini-Assembler assembles 
that instruction in absolute mode if the operand for that instruction is 
greater than $FF, and it assembles it in zero-page mode if the operand is less 
than $0100. 


Instructions in accumulator mode and implied addressing mode need no 
operands. 


Branch instructions, which use the relative addressing moue, require the 
target address of the branch. The Mini-Assembler calculates the relative 
distance to use in the instruction automatically. If the target address is more 
than 127 locations distant from the instruction, the Mini-Assembler sounds 
a bell (beep), displays a caret ( * ) under the target address, and does not 
assemble the line. 


If you give the Mini-Assembler the mnemonic for an instruction and an 
operand, and the addressing mode of the operand cannot be used with the 
instruction you entered, the Mini-Assembler will not accept the line. 


Summary of Monitor Commands 


Here is asummary of the Monitor commands, showing the syntax for each 
one. 


Examining Memory 
SSS SS SS SSS ee) 


\adrs| Examines the value contained in 
one location. 

{adrs1|./adrs2} Displays the values contained in all 
locations between {adrs1} and 
jadrs2}. 

Displays the values in up to eight 
locations following the last opened 
location. 
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Changing the Contents of Memory 


Moving and Comparing 


\dest| <|start}.jend|M 


\dest} <jstart}./end|V 


The Examine Command 
Se ee ee 


CONTROL } E | 


The Search Command 
a a pe eR are | 


\val| <jstart}.jend|S 

Cassette Tape Commands 
SSS E————eee| 
start} .{end|W 


start).{end|R 
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Stores the values in consecutive 
memory locations starting at jadrs}. 
Stores values in memory starting at 
the next changeable location. 


Copies the values in the range 
istart}./end) into the range 
beginning at jdest}. 

Compares the values in the range 
start|.;end} to those in the range 
beginning at |dest}. 


Displays the locations where the 
contents of the 65C02’s re gisters are 
stored and opens them for changing. 


Displays the address of the first 
occurrence of |val} in the specified 
range beginning at |start}. 


Writes the values in the memory 
range |start}./end| onto tape, 
preceded by a ten-second leader. 
Reads values from tape, storing 
them in memory beginning at {start} 
and stopping at jend}. Prints ERR if 
an error occurs. 


Miscellaneous Monitor Commands 


I Sets inverse display mode. 

N Sets normal display mode. 

Enters the language currently active 
(usually Applesoft). 

Returns to the language currently 
active (usually Applesoft). 

val} +|val; Adds the two values and prints the 
hexadecimal result. 

|val}-}val} Subtracts the second value from the 
first and prints the result. 

slot} [P] Diverts output to the device whose 


interface card is in slot number 
slot}. If |slot}=0, accepts input from 
the keyboard. 

Jumps to the machine-language 
subroutine at location $3F8. 


Running and Listing Programs 
Re rae ae a rn Foe ier ee) 


\adrs|G Transfers control to the machine 
language program beginning at 
jadrs|. 

[oon 
jadrs} L Disassembles and displays 20 


instructions, starting at |adrs}. 
Subsequent LIST commands 
display 20 more instructions. 
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Original lle 


The Mini-Assembler 
ESS 


The Mini-Assembler is available on an original Apple Ile only when 
Integer BASIC is active. See the earlier section “The Mini-Assermbler.” 


F666G 


$\command! 


SFF69G 
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Invokes the Mini-AssembLer on the 
original Apple Ile. 

Invokes the Mini-AssembLer on the 
enhanced Apple Ile. 

Executes a Monitor command from 
the Mini-Assembler on the original 
Apple Ile. 

Leaves the Mini-Assembler on the 
original Apple Ile. 

Leaves the Mini-Assembler on the 
enhanced Apple Ile. 
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ll Plus, Il 


Original lle 


The seven expansion slots on the Apple [le’s main circuit board are used for 
installing circuit cards containing the hardware and firmware needed to 
interface peripheral devices to the Apple Ile. These slots are not simple I/O 
ports; peripheral cards can access the Apple Ile’s data, address, and control 
lines via these slots. The expansion slots are numbered from 1 to 7, and 
certain signals, described below, are used to select a specific slot. 


The Apple II and Apple II Plus have an eighth expansion slot: slot 
number 0). On those models, slot 0 is normally used for a language card or 
a ROM card; the functions of the Apple II Language Card are built into the 
main circuit board of the Apple Ile. 


Interrupt support on the enhanced Apple Ile requires that special attention 
be paid to cards designed to be in slot 8. A description of what you need to 
watch for is given at the end of this chapter. 


The interrupt support built into the enhanced Apple Ile is an enhanced 
and expanded version of the interrupt support in the original Apple Ile. 


Peripheral-Card Memory Spaces 
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Because the Apple Ile’s microprocessor does all of its I/O through memory 
locations, portions of the Apple Ile’s memory space have been allocated for 
the exclusive use of the cards in the expansion slots. In addition to the 
memory locations used for actual I/O, there are memory spaces available 
for programmable memory (RAM) in the main memory and for read-only 
memory (ROM or PROM) on the peripheral cards themselves. 


The memory spaces allocated for the peripheral cards are described below. 
Those memory spaces are used for small dedicated programs such as I/O 
drivers. Peripheral cards that contain their own driver routines in firmware 
like this are called intelligent peripherals. They make it possible for you to 
add peripheral hardware to your Apple [le without having to change your 
programs, provided that your programs follow normal practice for data 
input and output. 


Peripheral-Card I/O Space 


EE SSS a eee ee 

Each expansion slot has the exclusive use of sixteen memory locations for 
data input and output in the memory space beginning at location $C090. 
Slot 1 uses locations $C090 through $CO9F, slot 2 uses locations $COA0 
through $COAF, and so on through location $COFF, as shown in Table 6-1. 


Chapter 6: Programming for Peripheral Cards 


Signals for which the active state is low are 
marked with a prime (’). 


These memory locations are used for different I/O functions, depending on 
the design of each peripheral card. Whenever the Apple Ile addresses one of 
the sixteen I/O locations allocated to a particular slot, the signal on pin 41 
of that slot, called DEVICE SELECT’, switches to the active (low) state. 
This signal can be used to enable logic on the peripheral card that uses the 
four low-order address lines to determine which of its sixteen I/O locations 
is being accessed. 


Table 6-1. Peripheral-Card I/O Memory Locations Enabled by DEVICE SELECT’ 


Slot Locations Slot Locations 

Sh $C090-$CO9F D $COD0-$CODF 
2 $COA0-SCOAF 6 $COE0-$COEF 
3 $COB0-$COBF 7 $COF0-SCOFF 
S $COC0-$COCF 


Peripheral-Card ROM Space 


One 256-byte page of memory space is allocated to each accessory card. 
This space is normally used for read-only memory (ROM or PROM) on the 
card with driver programs that control the operation of the peripheral 
device connected to the card. 


The page of memory allocated to each expansion slot begins at location 
$Cn00, where n is the slot number, as shown in Table 6-2 and Figure 6-3. 
Whenever the Apple Ile addresses one of the 256 ROM memory locations 
allocated to a particular slot, the signal on pin 1 of that slot, called I/O 
SELECT’, switches to the active (low) state. This signal enables the ROM or 
PROM devices on the card, and the eight low-order address lines determine 
which of the 256 memory locations is being accessed. 
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See the section “I/O Programming 
Suggestions” later in this chapter. 
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Important! 


Table 6-2. Peripheral-Card ROM Memory Locations Enabled by I/O SELECT’ 


Slot Locations Slot Location 

l $C0100-$C1FF 5) $C500-$C5FF 
2 $C0200-$C2FF 6 $C600-$C6FF 
3 $C0300-$C3FF 7 $C700-$C7FF 
4 $C0400-$C4FF 


Expansion ROM Space 
a gy NN ia Ss 


In addition to the small areas of ROM memory allocated to each expansion 
slot, peripheral cards can use the 2K-byte memory space from $C800 to 
$CFFF for larger programs in ROM or PROM. This memory space is called 
expansion ROM space. (See the memory map in Figure 6-3). Besidles being 
larger, the expansion ROM memory space is always at the same locations 
regardless of which slot is occupied by the card, making programs that 
occupy this memory space easier to write. 


This memory space is available to any peripheral card that needs it. More 
than one peripheral card can have expansion ROM on it, but only one of 
them can be active at a time. 


Each peripheral card that uses expansion ROM must have a circuit on it to 
enable the ROM. The circuit does this by a two-stage process: first, it sets a 
flip-flop when the I/O SELECT’ signal, pin 1 on the slot, becomes active 
(low); second, it enables the expansion ROM devices when the I/O 
STROBE’ signal, pin 20 on the slot, becomes active (low). Figure 6-1 shows 
a typical ROM-enable circuit. 


The 1/0 SELECT’ signal on a particular slot becomes active whenever the 
Apple Ile’s microprocessor addresses a location in the 256-byte ROM address 
space allocated to that slot. The I/O STROBE’ signal on all of the expansion 
slots becomes active (low ) when the microprocessor addresses a Location in 
the expansion-ROM memory space, $C800-$CFFF. The I/O STROBE’ signal 
is used to enable the expansion-ROM devices on a peripheral card.. (See 
Figure 6-1.) 


If there is an 80-column text card installed in the auxiliary slot, some of 
the functions normally associated with slot 3 are performed by the 
80-column text card and the built-in 80-column firmware. With the 
80-column text card installed, the [/O STROBE’ signal is not available on 
slot 8, so firmware in expansion ROM on a card in slot 8 will not run. 
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Figure 6-1. Expansion ROM Enable Circuit 


1/0 SELECT’ 


2K Byte 


1/0 STROBE’ ROM 


A program on a peripheral card can get exclusive use of the expansion ROM 
memory space by referring to location $CFFF in its initialization phase. This 
location is special: all peripheral cards that use expansion ROM must 
recognize a reference to $CFFF as a signal to reset their ROM-enable 
flip-flops and disable their expansion ROMs. Of course, doing so also 
disables the expansion ROM on the card that is about to use it, but the next 
instruction in the initialization code sets the flip-flop in the expansion-ROM 
enable circuit on the card. 


A card that needs to use the expansion ROM space must first insert its slot 
address ($Cn) in $07F8 before it refers to $CFFF. This allows interrupting 
devices to reenable the card’s expansion ROM after interrupt handling is 
finished. Once its slot address has been inserted in $07F8, the peripheral 
card has exclusive use of the expansion memory space and its program can 
jump directly into the expansion ROM. 


Figure 6-2. ROM Disable Address Decoding 


To RESET, ROM Enable 
Flip-Flop 
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Important! 


As described earlier, the expansion-ROM disable circuit resets the enable 
flip-flop whenever the 65C02 addresses location $CFFF. To do this, the 
peripheral card must detect the presence of $CFFF on the address bus. You 
can use the 1/O STROBE’ signal for part of the address decoding, since it is 
active for addresses from $C800 through $CFFF. If you can afford to 
sacrifice some ROM space, you can simplify the address decoding even 
further and save circuitry on the card. For example, if you give up the last 
256 bytes of expansion ROM space, your disable circuit only needs to detect 
addresses of the form $CFxx, and you can use the minimal disable-decoding 
circuitry shown in Figure 6-2. 


Applesoft addresses two locations in the $CFxx space, thereby resetting 
the enable flip-flop. If your peripheral device is going to be used. with 
Applesoft programs, you must either use the full address decoding or else 
enable the expansion ROM each time it is needed. 


Peripheral-Card RAM Space 


ES Ea 

There are 56 bytes of main memory allocated to the peripheral cards, eight 
bytes per card, as shown in Table 6-3. These 56 locations are actually in the 
RAM memory reserved for the text and low-resolution graphics displays, 
but these particular locations are not displayed on the screen and their 
contents are not changed by the built-in output routine COUT 1. Programs in 
ROM on peripheral cards use these locations for temporary data storage. 


Table 6-3. Peripheral-Card RAM Memory Locations 


Base Slot Number 
Address 1 2 o* 4 5 6 7 


$0478 $0479 $047A $047B* $047C $047D $047E $047F 
$04F8 $04F9 $04FA $04FB* $04FC $04FD $04FE $04FF 
$0578 $0579  $057A $057B* $057C $057D $057E $057F 
$05F8 $05F9 $05FA $05FB* $05FC $05FD $05FE $05FF 
$0678 $0679  $067A $067B* $0670 $067D S067E S067F 
$06F8 $06F9 $06FA S06FB* $06FC $06FD $06FE SO06FF 
$0778 $0779 $077A = $077B* $0770 $077D $077E = S077F 
S07F8 $07F9 $O7FA $07FB* $07FC $07FD $07FE S07FF 


* If there is a card in the auxiliary slot, it takes over these locations. 
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A program on a peripheral card can use the eight base addresses shown in 
the table to access the eight RAM locations allocated for its use, as shown in 
the next section, “I/O Programming Suggestions.” 


AWarning The Apple Ile firmware sets the value of $04FB to $FF on a reset, even if 
there is no 80-column card installed. 


1/O Programming Suggestions 

a a aa ae ae ee a ee ae 
A program in ROM on a peripheral card should work no matter which slot 
the card occupies. If the program includes a jump to an absolute location in 
one of the 256-byte memory spaces, then the card will work only when it is 
plugged into the slot that uses that memory space. If you are writing the 
program for a peripheral card that will be used by many people, you should 
avoid placing such a restriction on the use of the card. 


Important! To function properly no matter which slot a peripheral card is installed 
in, the program in the card’s 256-byte memory space must not make any 
absolute references to itself. Instead of using jump instructions, you 
should force conditions on branch instructions, which use relative 
addressing. 


The first thing a peripheral-card used as an I/O device must do when called 
is to save the contents of the Apple Ie’s microprocessor’s registers. 
(Peripheral cards not being used as I/O devices do not need to save the 
registers.) The device should save the register’s contents on the stack, and 
restore them just before returning control to the calling program. If there is 
RAM on the peripheral card, the information may be stored there. 


Most single-character I/O is done via the microprocessor’s accumulator. A 
character being output through your subroutine will be in the accumulator 
with its high bit set when your subroutine is called. Likewise, if your 
subroutine is performing character input, it must leave the character in the 
accumulator with its high bit set when it returns to the calling program. 
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Finding the Slot Number With ROM Switched In 


ee ee ee SS eee 

The memory addresses used by a program on a peripheral card differ 
depending on which expansion slot the card is installed in. Before it can 
refer to any of those addresses, the program must somehow determine the 
correct slot number. One way to do this is to execute a JSR (jump to 
subroutine) to a location with an RTS (return from subroutine) instruction 
in it, and then derive the slot number from the return address saved on the 
stack, as shown in the following example. 


PHP 
SEI 
JSR KNOWNRTS 


save status 

inhibit interrupts 

-> a known RTS instruction... 
-.ethat you set up 


we we we we we we we we 


TSX get high byte of the... 

LDA $01866,X - return address from stack 
AND #$6F low-order digit is slot no. 
PLP restore status 


The slot number can now be used in addressing the memory allocated to the 
peripheral card, as shown in the next section. 


I/O Addressing 


Sea ees 

Once your peripheral-card program has the slot number, the card can use 
the number to address the I/O locations allocated to the slot. Table 6-4 
shows how these locations are related to sixteen base addresses starting 
with $C080. Notice that the difference between the base address and the 
desired I/O location has the form $n0, where n is the slot number. Starting 
with the slot number in the accumulator, the following example computes 
this difference by four left shifts, then loads it into an index regis ter and 
uses the base address to specify one of sixteen I/O locations. 


ASL ; get n into... 

ASL : 

ASL 1 

ASL ; «--ehigh-order nybble... 

TAX : . of index register. 

LDA $C@88,X ; load from first I/0 location 
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See the section “Setting Bank Switches” in 
Chapter 4 for more information. 


Selecting Your Target: You must make sure that you get an 


appropriate value into the index register when you address I/O locations 
this way. For example, starting with 1 in the accumulator, the 
instructions in the above example perform an LDA from location $C090, 
the first I/O location allocated to slot 1. If the value in the accumulator 

had been 0, the LDA would have accessed location $C080, thereby setting 
the soft switch that selects the second bank of RAM at location $D000 


and enables it for reading. 


Table 6-4. Peripheral-Card I/O Base Addresses 


Base 


Address 


$C080 
$C081 
$C082 
$C083 
$C084 
$0085 
$C086 
$C087 
$0088 
$C089 
$CO8A 
3C08B 
sC08C 
$C08D 
SCO8E 
$CO8F 


1 

$C090 
$C091 
$C092 
$C093 
$C094 
$C095 
$C096 
$C097 
$C098 
$C099 
SCO9A 
$CO9B 
$CO9C 
sCO9D 
SCO9E 
$CO9F 


2 

$COA0 
$COAL 
SCOA2 
$COA8 
$COA4 
$COA5 
SCOA6 
$COA7 
SCOA8 
$COA9 
SCOAA 
SCOAB 
SCOAC 
SCOAD 
SCOAE 
SCOAF 
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Connector Number 


3 

$COBO 
$COB1 
$COB2 
$COB3 
$COB4 
$COB5 
$COB6 
$COB7 
$COB8 
$COB9 
SCOBA 
$COBB 
SCOBC 
$COBD 
$COBE 
$COBF 


4 

$COCO 
$COC1 
$C0C2 
$C0C3 
$C0C4 
$COC5 
$C0C6 
$COC7 
$C0C8 
$COCI 
$COCA 
$COCB 
$COCC 
dCOCD 
$COCE 
$COCF 


3D 

$COD0 
$COD1 
$COD2 
$COD3 
$COD4 
$COD5 
$COD6 
$COD7 
$COD8 
$COD9 
$CODA 
$CODB 
$CODC 
$CODD 
$CODE 
$CODF 


6 

$COEO 
$COE1 
$COE2 
$COE3 
$COEK4 
$COE5 
$COE6 
$COE7 
SCOE8 
$COE9 
SCOEA 
SCOEB 
$COEC 
SCOED 
SCOEE 
SCOEF 


7 

$COFO 
SCOF 1 
$COF2 
$COF3 
$COF4 
$COF5 
$COF6 
SCOF7 
$COF8 
SCOF9 
SCOFA 
SCOFB 
$COFC 
$COFD 
SCOFE 
$COFF 
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AWarning 


RAM Addressing 


—SEEE—————————————— 

A program on a peripheral card can use the eight base addresses shown in 
Table 6-3 to access the eight RAM locations allocated for its use. The 
program does this by putting its slot number into the Y index register and 
using indexed addressing mode with the base addresses. The base 
addresses can be defined as constants because they are the same no matter 
which slot the peripheral card occupies. 


If you start with the correct slot number in the accumulator (by using the 
example shown earlier), then the following example uses all eight RAM 
locations allocated to the slot. 


TAY 

LDA $0478,Y 
STA $04F8,Y 
LDA $6578,Y 
STA $OSF8,Y 
LDA $6678,Y 
STA $06F8,Y 
LDA $0778,Y 
STA $07F8,Y 


You must be very careful when you have your peripheral-card program 
store data at the base-address locations themselves since they are 
temporary storage locations; the RAM at those locations is used by the 
disk operating system. Always store the first byte of the ROM location of 
the expansion slot that is currently active ($Cn) in location $7F'8, and the 
first byte of the ROM location of the slot holding the controller card for 
the startup disk drive in location $5F8. 
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See “The Standard I/O Links” in Chapter 3. 


COUT1 and BASICOUT are described in 
Chapter 3. 


KEYIN and BASICIN a re described in 
Chapter 3. 


Changing the Standard 1!/O Links 
ee ee ee ee 


There are two pairs of locations in the Apple IIe that are used for controlling 
character input and output. They are called the I/O links. In a Apple Ile 
running without a disk operating system, the I/O links normally contain the 
starting addresses of the standard input and output routines—KEYIN and 
COUT] if the 80-column firmware is not active, BASICIN and BASICOUT if 
the 80-column is active. If a disk operating system is running, one or both of 
the links will hold the addresses of the operating system input and output 
routines. 


The link at locations $36 and $37 (decimal 54 and 55) is called CSW, for 
character output switch. Individually, location $36 is called COWL (CSW 
Low) and location $37 is called CSWH (CSW High). CSW holds the starting 
address of the subroutine the Apple Ile is currently using for 
single-character output. This address is normally $FDFO, the address of 
routine COUT1, or $C307, the address of BASICOUT. 


When you issue a PR#n from BASIC or ann from the 
Monitor, the Apple Ile changes this link address to the first address in the 
ROM memory space allocated to slot number n. That address has the form 
$Cn00. Subsequent calls for character output are thus transferred to the 
program on the peripheral card. That program can use the instruction 
sequences given above to find its slot number and use the I/O and RAM 
locations allocated to it. When it is finished, the program can execute an 
RTS (return from subroutine) instruction to return control to the calling 
program, or jump to the output routine COUT! at location $FDF0 to display 
the output character (which must be in the accumulator) on the screen, 
then let COUT return to the calling program. 


A similar link at locations $38 and $39 (decimal 56 and 57) is called KSW, 
for keyboard input switch. Individually, location $38 is called KSWL (for 
KSW low) and location $89 is called KSWH (KSW high). KSW holds the 
starting address of the routine currently being used for single-character 
input. This address is normally $FD1B, the starting address of KEYIN, or 
$C305, the address of BASICIN. 


I/O Programming Suggestions Loe 


important! 


See the ProDOS Technical Reference 
Manual for more about using link 
addresses. 


Refer to the section on input and output 
link registers in the DOS Programmer's 
Manual and the ProDOS Technical 
Reference Manual for further details. 


When you issue an IN#n command from BASIC or ann from 
the Monitor, the Apple Ile changes this link address to $Cn00, the beginning 
of the ROM memory space that is allocated to slot number n. Subsequent 
calls for character input are thus transferred to the program on the 
accessory card. That program can use the instruction sequences given 
above to find its slot number and use the I/O and RAM locations allocated 
to it. The program should put the input character, with its high bit set, into 
the accumulator and execute an RTS instruction to return control to the 
program that requested input. 


When a disk operating system (ProDOS or DOS 8.3) is running, one or both 
of the standard [I/O links hold addresses of the operating system’s input and 
output routines. The operating system has internal locations that hold the 
addresses of the character input and output routines that are currently 
active. 


If a program that is running with ProDOS or DOS 3.3 changes the 
standard link addresses, either directly or via IN# and PR# cornmands, 
the operating system is disconnected. 


To avoid disconnecting the operating system each time a BASIC program 
initiates I/O to a slot, it should use either an IN# or a PR# command from 
inside a PRINT statement that starts with a Control-D character. For 
assembly-language programs, there is a DOS 3.3 subroutine call to use when 
changing the link addresses. After changing CSW or KSW, the program calls 
this subroutine at location $03EA (decimal 1002). The subroutine transfers 
the link address to a location inside the operating system and then restores 
the operating system address in the standard link location. 


Other Uses of |/O Memory Space 


2 SUS Ck eyelet | 
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The portion of memory space from location $C000 through $CFFE (decimal 
49152 through 53247) is normally allocated to 1/0 and program memory on 
the peripheral cards, but there are two other functions that also use this 
memory space: the built-in self-test firmware and the 80-column display 
firmware. The soft switches that control the allocation of this memory 
space are described in the next section. 
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Figure 6-3. 1/0 Memory Map 


CFFF 


Internal 
ROM and 
Peripheral 


Peripheral 


Expansion 
ROM 


Expansion ROM 


Internal 
ROM 


C800 
C700 
Slot 6 ROM 
C600 
C500 
C400 
sero | [ao 
C300 


Slot 2 ROM 


Slot 1 ROM 


Internal Soft Switches and Peripheral 1/0 


Switching |/O Memory 


The built-in firmware uses two soft switches to control the allocation of the 
I/O memory space from $C000 to $CFFF. The locations of these soft 
switches, SLOTCXROM and SLOTC3ROM, are given in Table 6-5. 


Note: Like the display switches described in Chapter 2, these soft 
switches share their locations with the keyboard data and strobe 
functions. The switches are activated only by writing, and the states can 
be determined only by reading, as indicated in Table 6-5. 
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Table 6-5. 1/0 Memory Switches 


Location 
Name Function Hex Decimal Notes 
SLOTC3ROM Slot ROM at $C300 $COOB 49168 -163873 Write 


Internal ROM at $C300 $COOA 49162 -16374 Write 
Read SLOTC3ROM switch $C017 49175 -16361 Read 


SLOTCXROM § Slot ROM at $Cx00 $C006 49159 -16377 Write 
Internal ROM at $Cx00 $C007 49158 -16378 Write 
Read SLOTCXROM switch $C015 49173 -16363 Read 


When SLOTC3ROM is on, the 256-byte ROM area at $C300 is available to a 
peripheral card in slot 3, which is the slot normally used for a terminal 
interface. If a card is installed in the auxiliary slot when you turn on the 
power or reset the Apple Ile, the SLOT3ROM switch is turned off. Turning 
SLOTC3ROM off disables peripheral-card ROM in slot 8 and enables the 
built-in 80-column firmware, as shown in Figure 6-3. The 80-column 
firmware is assigned to slot-3 address space because slot 3 is normally used 
with a terminal interface, so the built-in firmware will work with programs 
that use slot 3 this way. 


The bus and I/O signals are always available to a peripheral card in slot 3, 
even when the 80-column hardware and firmware are operating. Thus it is 
always possible to use this slot for any I/O peripheral that does veo¢ have 
built-in firmware. 


When SLOTCXROM is active (high), the I/O memory space from $C100 to 
$C7FF is allocated to the expansion slots, as described previously. Setting 
SLOTCXROM inactive (low) disables the peripheral-card ROM and selects 
built-in ROM in all of the I/O memory space except the part from $C000 to 
$COFF (used for soft switches and data I/O), as shown in Figure 6-3. In 
addition to the 80-column firmware at $C300 and $C800, the built-in ROM 
includes firmware that performs the self-test of the Apple Ile’s hardware. 


Note: Setting SLOTCXROM low enables built-in ROM in all of the I/O 
memory space (except the soft-switch area), including the $C300 space, 
which contains the 80-column firmware. 
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Developing Cards for Slot 3 


Original lle 


For more information about the $C300 
firmware, see the Monitor ROM listing in 
Appendix I of this manual. Especially note 
the portion from $C300 through $C420. 


In the original Apple Ile firmware, the internal slot 3 firmware was 
always switched in if there was an 80-column card (either 1K or 64K) in 
the auxiliary slot. This means that peripheral cards with their own ROM 
were effectively switched out of slot 8 when the system was turned on. 


With the enhanced Apple Ile Monitor ROM, the rules are different. A 
peripheral card in slot 3 is now switched in when the system is started up or 
when is pressed if the card’s ROM has the following ID bytes: 


$0305 = $38 
$C307 = $18 


The enhanced Apple Ile firmware requires that interrupt code be present in 
the $C8 page (either external or internal). A peripheral card in slot 3 must 
have the following code to support interrupts. After this segment, the code 
continues execution in the internal ROM at $C400. 


$C3F 4: IRQDONE STA $C081 Read ROM, write RAM 
JMP $FC7A ;Jump to $F8 ROM 
IRQ 
BIT $C015 ‘slot or internal ROM 
STA $C987 force in internal ROM 


When programming for cards in slot 38: 


o You must support the AUXMOVE and XFER routines at $C312 and 
$0314. 


o Don’t use unpublished entry points into the internal $Cn00 firmware, 
because there is no guarantee that they will stay the same. 


o If your peripheral card is a character I/O device, you must follow the 
Pascal 1.1 firmware protocol, described in the next section. 
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Pascal 1.1 Firmware Protocol 


The Pascal 1.1 firmware protocol was originally developed to be used with 
Apple Pascal 1.1 programs. The protocol is followed by all succeeding 
versions of Apple II Pascal, and can be used by programmers using other 
languages as well. 


The Pascal 1.1 firmware protocol provides Apple Ile programmers with 


oO astandard way to uniquely identify new peripheral cards 
oO astandard way to address the firmware routines in peripheral cards. 


Device Identification 
aaa ey ee a) 


The Pascal 1.1 firmware protocol uses four bytes near the beginning of the 
peripheral card’s firmware to identify the peripheral card. 


Address Value 


$Cs05 $38 (like the old Apple II Serial Interface Card) 
$Cs07 ~—«- $18 (like the old Apple II Serial Interface Card) 
$CsOB $01 (the generic signature of new cards) 
$Cs0C —_— $ci (the device signature) 


The first hexadecimal digit, c, of the device signature byte identifies the 
device class and the second hexadecimal digit, 1, of the device signature 
byte is a unique identifier for the card, used by some manufacturers for 
their cards. Table 6-6 shows the device class assignments. 


Table 6-6. Peripheral-Card Device-Class Assignment 


Digit Device Class 
$0 Reserved 


$1 Printer 

$2 Joystick or other X-Y input device 
$3 Serial or parallel I/O card 

$4 Modem 

$5 Sound or speech device 

$6 Clock 

$7 Mass storage device 

$8 80-column card 

$9 Network or bus interface 

SA Special purpose (none of the above) 


$B-F Reserved for future expansion 
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For example, the Apple II Super Serial Card has a device signature of $31: 
the 38 signifies that it is a serial or parallel 1/0 card, and the 1 is the 
low-order digit supplied by Apple Technical Support. 


Although version 1.1 of Pascal ignores the device signature, applications 
programs can use them to identify specific devices. 


I/O Routine Entry Points 


———_—————— es 

Indirect calls to the firmware in a peripheral card are done through a 
branch table in the card’s firmware. The branch table of I/O routine entry 
points is located near the beginning of the Cs00 address space (s being the 
slot number where the peripheral card is installed). 


The branch table locations that Pascal 1.1 firmware protocol uses are as 
follows: 


Address Contains 


$CsOD Initialization routine offset (required) 
$CsOE Read routine offset (required) 

$CsOF Write routine offset (required) 

$Csl10 Status routine offset (required) 

$Cs11 $00 if optional offsets follow; non-zero if not 
$Csl2 Control routine offset (optional) 

$Csl3 ‘Interrupt handling routine offset (optional) 


Notice that $Cs11 contains $00 only if the control and interrupt handling 
routines are supported by the firmware. (For example, the SSC does not 
support these two routines, and so location $Cs11 contains a non-zero 
firmware instruction.) Apple II Pascal 1.0 and 1.1 do not support control and 
interrupt requests, but such requests are implemented in Pascal 1.2 and 
later versions and in ProDOS. 
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Table 6-7 gives the entry point addresses and the contents of the 65C02 
registers on entry to and on exit from Pascal 1.1 I/O routines. 


Table 6-7. 1/O Routine Offsets and Registers Under Pascal 1.1 Protoco] 


Addr. Offset for X Register Y Register A Register 
$CsOD Initialization 

On entry $Cs $s0 

On exit Error code (unchanged) (unchanged) 
$CsOE Read 

On entry $Cs $s0 

On exit Error code (unchanged) Character read 
$CsOF Write 

On entry $Cs $50 Char. to write 

On exit Error code (unchanged) (unchanged) 
$Csl0 Status 

On entry $Cs $s0 Request (0 or 1) 

On exit Error code (changed) (unchanged) 
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For more about interrupt support in 
ProDOS, see the ProDOS Technical 
Reference Manual. 


For information about interrupt handling 
with Apple Pascal 1.2, see the Device and 
Interrupt Support Tools Manual which 
is part of the Apple IT Device Support Tools 
package (A2W0C14). 
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The original Apple Ile offered little firmware support for interrupts. The 
enhanced Apple Ile’s firmware provides improved interrupt support, very 
much like the Apple IIc’s interrupt support. Neither machine disables 
interrupts for extended periods. 


Interrupts work on enhanced Apple [le systems with an installed 80-column 
text card (either 1K or 64K) or a peripheral card with interrupt-handling 
ROM in slot 3. Interrupts are easiest to use with ProDOS and Paseal 1.2 
because they have interrupt support built in. DOS 3.3 has no built-in 
interrupt support. 


The new interrupt handler operates like the Apple IIc interrupt handler, 
using the same memory locations and operating protocols. The main 
purpose of the interrupt handler is to support interrupts in any memory 
configuration. This is done by saving the machine’s state at the tame of the 
interrupt, placing the Apple in a standard memory configuration before 
calling your program’s interrupt handler, then restoring the original state 
when your program’s interrupt handler is finished. 
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What Is an Interrupt? 


An interrupt is a hardware signal that tells the computer to stop what it is 
currently doing and devote its attention to a more important task. Print 
spooling and mouse handling are examples of interrupt use, things that 
don’t take up all the time available to the system, but that should be taken 
care of promptly to be most useful. 


For example, the Apple Ile mouse can send an interrupt to the computer 
every time it moves. If you handle that interrupt promptly, the mouse 
pointer’s movement on the screen will be smooth instead of jerky and 
uneven. 


Interrupt priority is handled by a daisy-chain arrangement using two pins, 
INT IN and INT OUT, on each peripheral-card slot. As described in 
Chapter 7, each peripheral card breaks the chain when it makes an 
interrupt request. On peripheral cards that don’t use interrupts, these pins 
should be connected together. 


The daisy chain gives priority to the peripheral card in slot 7: if this card 
opens the connection between INT IN and INT OUT, or if there is no card in 
this slot, interrupt requests from cards in slots 1 through 6 can’t get 
through. Similarly, slot 6 controls interrupt requests (IRQ) from slots 1 
through 5, and so on down the line. 


When the IRQ’ line on the Apple Ile’s microprocessor is activated (pulled 
low), the microprocessor transfers control through the vector in locations 
$FFFE-$FFFF. This vector is the address of the Monitor’s interrupt handler, 
which determines whether the request is due to an external IRQ or a BRK 
instruction and transfers control to the appropriate routine via the vectors 
stored in memory page 3. The BRK vector is in locations $03F0-$03F1 and 
ProDOS uses the IRQ vector in locations $03FE-$03FF. (See Table 4-11.) 
The Monitor normally stores the address of its reset routine in the IRQ 
vector; you should substitute the address of your program’s 
interrupt-handling routine. 


Apple Pascal doesn’t use the BRK vector at $03F0-$03F1, but it does use the 
IRQ vector at $03FE-$03FF. 


Interrupts on the Enhanced Apple Ile 147 


148 


Original lle 


Original lle 


Interrupts on Apple Il Series Computers 
a an ca NE AEs ee 


The interrupt handler built in to the enhanced Apple Ile’s firmware saves 
the contents of the accurnulator on the stack. (The original Apple Ile saves 
the contents of the accumulator at location $45.) DOS 3.3, as well as the 
Monitor, rely on the integrity of location $45, so this change lets both 

DOS 3.3 and the Monitor continue to work with active interrupts on the 
enhanced Apple Ile. 


Since the built-in interrupt handler on the original Apple Ile uses location 
$45 to save the contents of the accumulator, the operating system fails 
when an interrupt occurs under DOS 3.3 on the original Apple Lle. 


If you want to write programs that use interrupts while running on the 
original Apple Ile, Apple II Plus, or Apple II, you must use either ProDOS 
or Apple II Pascal 1.2 (or later versions). Both these operating s ystems 
give you full interrupt support, even though these versions of tlhe Apple II 
don’t include interrupt support in their firmware. (Versions of Pascal 
before 1.2 do not work with interrupts enabled on an original A pple Ile.) 


Some other manufacturer’s hardware, such as co-processor cards , don’t 
work properly in an interrupting environment. If you are trying to develop 
an application and encounter this problem, check with the manufacturer of 
the card to see if a later version of the hardware or its software will operate 
properly with interrupts active. You may not be able to use interrupts if an 
interrupt-tolerant version isn’t available. 


Interrupts are effective only if they are enabled most of the time. Interrupts 
that occur while interrupts are disabled will not be serviced. 


Pascal, DOS 3.8, and ProDOS turn off interrupts while performing disk 
operations because of the critical timing of disk read and write operations. 
Some peripheral cards used in the Apple Ile disable interrupts while reading 
and writing. 


Although the enhanced Apple Ile firmware never disables interrupts 
during screen handling, the original Apple Ile periodically turns 
interrupts off while doing 80-column screen operations. The efffect is most 
noticeable while the screen is scrolling. 
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Important! 


Important! 


See the section “Developing Cards for 
Slot 3” earlier in this c hapter. 


Don’t use PR#6 to restart your Apple Ile while running ProDOS with 
interrupts enabled since PR#6 doesn’t disable interrupts. If you try it, 
ProDOS will fail as it starts up since its interrupt handlers aren't yet set 
up. If you have to restart, use [CONTROL } RESET ], or make sure that your 
program disables interrupts before it ends. 


Rules of the Interrupt Handler 
—————_——— EEE SS ee aes 


Unlike the Apple IIc, the enhanced Apple Ile’s interrupt handling firmware 
is not always switched in. Here are the reasons why this is so and the 
implications that necessarily follow. 


There is xo part of memory in the Apple Ile that is always switched in. 
Thus, there is no location for an interrupt handler that works for all 
memory configurations. However, the $C3 page of firmware is present on all 
systems that have 80-column text cards in their auxiliary slots, so it was 
selected as the starting location of the built-in interrupt handling routine. 


There are two factors that determine if the $C3 firmware is switched in and 
therefore whether or not interrupts will be usable: 


o Is there an 80-column text card in the auxiliary slot? 
O If not, is there a peripheral card in slot 8 with built-in ROM with bytes 
$C305 = $38 and $0307 = $18? 


The Apple IIe’s memory is switched according to the following rules at both 
powerup and reset: 


oO If there is a ROM card in slot 3, but no text card in the auxiliary slot, the 
firmware on the ROM card is switched in. This is necessary for Pascal to 
work. 

oO If there is a text card in the auxiliary slot, but no ROM card in slot 3, the 
internal $C3 firmware is switched in. 

o If there is both a text card in the auxiliary slot and a ROM card in slot 3, 
the firmware on the ROM card is switched in. 


These rules mean that systems without 80-column text cards in the 
auxiliary slot do not have their internal $C3 firmware switched in. Such 
systems cannot handle interrupts or breaks (the software equivalent of 
interrupts). An application program must swap in the $C3 firmware both 
on initialization and after reset to make interrupts function properly on 
such a machine configuration. (ProDOS versions 1.1 and later do this for 
you during startup.) 
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Another implication of the decision to have interrupt code in the $C3 page 
affects the shared $C800 space in the Apple IIe. When the $C3 page is 
referenced, the Ile hardware automatically switches in its own $C800 
space. When the interrupt handler finishes, it restores the $C800 space to 
the original owner using MSLOT ($07F8). This means that it is very 
important for a peripheral card to place its slot address in MSLOT to support 
interrupts while code is being executed in its $C800 space. 


Interrupt Handling on the 65C02 and 6502 


ES] a ee ee) 
There are three possible conditions that will allow interrupts on the 65C02 
and 6502: 


oO The IRQ line on the microprocessor is pulled low after a CLI instruction 
has been used (interrupts are not masked). This is the standard 
technique that devices use when they need immediate attention. 

o The microprocessor executes a break instruction (BRK = opcode $00). 

o Anon-maskable interrupt (NMI) occurs. The microprocessor services 
this interrupt whether or not the CLI instruction has been used. An NMI 
is completely independent of the interrupts discussed in this manual. 


The microprocessor saves the current program counter and status byte on 
the stack when an interrupt occurs and then jumps to the routine whose 
address is stored in $FFFE and $FFFF. The sequence of operations 
performed by the microprocessor 1s as follows: 


1. It finishes executing the current instruction if an IRQ is encountered. (If 
a BRK instruction is encountered, the current instruction is already 
finished. ) 


. It pushes the high byte of the program counter onto the stack. 
. It pushes the low byte of the program counter onto the stack. 
. It pushes the processor status byte onto the stack. 

. Itexecutes a JMP ($FFFE) instruction. 


OI mm © DS 


The Interrupt Vector at $FFFE 


Three separate regions of memory contain address $FFFE in an A pple Ile 
with an Extended 80-Column Text Card: the built-in ROM, the 
bank-switched memory in main RAM, and the bank-switched memory in 
auxiliary RAM. The vector at $FFFE in the ROM points to the built-in 
interrupt handling routine. You must copy the ROM’s interrupt vector to the 
other banks yourself if you plan to use interrupts with the bank-s-witched 
memory switched in. 
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The Built-in Interrupt Handler 


The enhanced Apple Ile’s built-in interrupt handler records the computer’s 
current memory configuration, then sets the computer’s memory 
configuration to a standard state so that your program’s interrupt handler 
always begins running in the same memory configuration. 


Next the built-in interrupt handler checks to see if the interrupt was caused 
by a break instruction, and handles it as just described under “Interrupt 
Handling on the 65C02 and 6502.” If it was not a break, it passes control to 
the interrupt handling routine whose address is stored at $8FE and $8FF of 
main memory. Normally, that would be the operating system’s interrupt 


Interrupt handler installation is described | handler, unless you have installed one of your own. 
in the ProDOS Technical Reference _ a 
Manual and the Device and Interrupt After your program’s interrupt handler returns (with an RTI), the built-in 


Support Tools Manual, which is part of interrupt handler restores the memory configuration, and then does another 

the Apple Ile Device Support Tools package ~~ RT to return to where it was when the interrupt occurred. Figure 6-4 

(A2ZWO0014). illustrates this entire process. Each of these steps is explained later in this 
chapter. 


Figure 6-4. Interrupt-Handling Sequence 


Interrupted 
Program Processor Built-in Handler User’s Handler 


Program ———* Push Address 
Push Status 
JMP ($FFFE) ——* Save old and set new 
memory configuration 


If BRK, then go to break 
handler ($FA47). —————____ 


Our interrupt? 
NO: Push Address 
Push Status 
JMP ($3FE) — Handle interrupt 


YES: Handle it. 


Restore memory “— RTI 
configuration 


Pull Status “—— RTI 
Program “—— Pull Address 
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Important! 


Saving the Apple lle’s Memory Configuration 
SSS aa a ee ee 


The built-in interrupt handler saves the Apple IIe’s memory configuration 
and then sets it to a known state according to these rules: 


oO Text Page 1 is switched in (PAGE2 off) so that main screen holes are 
accessible if 80STORE and PAGE2 are on. 


Main memory is switched in for reading (RAMRD off). 

Main memory is switched in for writing (RAMWRT off). 
$D000-$F FFF ROM is switched in for reading (RDLCRAM off). 
Main stack and zero page are switched in (ALTZP off). 


The auxiliary stack pointer is preserved, and the main stack pointer is 
restored. (See the next section, “Managing Main and Auxiliary Stacks.”) 


OoOaqd0 0 


Because main memory is switched in, all memory addresses used later in 
this chapter are in main memory unless otherwise specified. 


Managing Main and Auxiliary Stacks 
a a a ed 


Apple has adopted a convention that allows the Apple Ile to be run with two 
separate stack pointers since the Apple Ile with an Extended 80-Column 
Text Card has two stack pages. Two bytes in the auxiliary stack page are 
used as storage for inactive stack pointers: $0100 for the main stack pointer 
when the auxiliary stack is active, and $0101 for the auxiliary stack pointer 
when the main stack is active. 


When a program using interrupts switches in the auxiliary stack for the 
first time, it must place the value of the main stack pointer at $0100 (in the 
auxiliary stack) and initialize the auxiliary stack pointer to $FF (the top of 
the stack). When it subsequently switches from one stack to the other, it 
must save the current stack pointer before loading the pointer for the other 
stack. 


The current stack pointer is stored at $0101, and the main stack pointer is 
retrieved from $0100 when an interrupt occurs while the auxiliary stack is 
switched in. Then the main stack is switched in for use. The stack pointer 
is restored to its original value after the interrupt has been handled. 
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Important! 


The built-in XFER routine does not support this procedure. If you are 


using XFER to swap stacks, you must use code like the following to set up 


the stack pointers and stack. 


This example transfers control from a code segment running 
using the main stack to one running using the aux stack. 


XFERALT 


PHP 
PLA 
SEI 
TSX 
STA 
STX 
LDX 
TXS 
PHA 
PLP 


LDA 
STA 
LDA 
STA 


SETALT2ZP 
$188 
$161 


#DESTL 
$3ED 
#DESTH 
$3EE 


SEC/CLC 


BIT 
JMP 


STX 
LDX 


RTS 
XFER 


$181 
$1686 


STA SETSTDZP 


CLV 


;preserve interrupt status in A 
;disable interrupts 
;Save main stack pointer at $168 
;and swap zero pages 


;now restore aux stack pointer 


sand interrupt status 


sset destination address 


sset direction of transfer 
;V=1 for alt zero page CRTS=$60) 
sdo transfer 


To transfer control the other direction, change the following lines 


;V=8 for main zp 
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AWarning 


The User’s Interrupt Handler at $3FE 


_———S>ES>SEE—EE——ESEE——————S—— SS ee aed 

If your program has an interrupt handler, it must place the entry address of 
that handler at $03FE. After it sets the machine to a standard state, the IIe’s 
internal interrupt handler transfers control to the routine whose address is 
in the vector at $03FE. 


It is very important for a peripheral card to place its slot address in MSLOT 
to support interrupts whenever it is executing code in its $C800 space. 
Whenever the $C3 page is referenced, the IIe automatically switclies in its 
own $C800 ROM space. When the interrupt handler finishes, it restores the 
$C800 space to the original owner using MSLOT ($07F8). 


Be careful to install interrupt handlers according to the rules of the 
operating system that you are using. Placing the address of your 
program’s interrupt handler at $03FE disconnects the operating system’s 
interrupt handler. 


The $03FE interrupt handler must do these things: 


1. Verify that the interrupt came from the expected source. 
2. Handle the interrupt as desired. 

8. Clear the appropriate interrupt soft switch. 

4. Return with an RTT. 


Here are some things to remember if you are dealing with programs that 
must run in an interrupt enviroment: 


oO There is no guaranteed maximum response time for interrupts because 
the system may be doing a disk operation that lasts for several seconds. 


oO Once the built-in interrupt handler is called, it takes at least 150 to 
200 microseconds for it to call your interrupt handling routine. After your 
routine returns, it takes 40 to 140 microseconds to restore memory and 
return to the interrupted program. 


Oo If memory is in the standard state when the interrupt occurs, the total 
overhead for interrupt processing is about 150 microseconds less than if 
memory is in the worst state. (The worst state is one that requires the 
most work to set up for: 30STORE and PAGE2 on; auxiliary memory 
switched in for reading and writing; bank-switched memory page 2 in the 
auxiliary bank switched in for reading and writing: and interna] $Cn00 
ROM switched in). 

oO Interrupt overhead will be greater if your interrupt handler is installed 
through an operating system’s interrupt dispatcher. The length of delay 
depends on the operating system, and on whether the operating system 
dispatches the interrupt to other routines before calling yours. 
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Handling Break Instructions 


SSS a ee ere 

The 65C02 treats a break instruction (BRK, opcode $00) just like a hardware 
interrupt. After the interrupt handler sets the memory configuration, it 
checks to see if the interrupt was caused by a break (bit 4 of the status byte 
is set), and if it was, jumps to a break handling routine. This routine saves 
the state of the computer at the time of the break as shown in Table 6-8. 


Table 6-8. BRK Handler Information 


Information Location 
Program counter (low byte) $3A 
Program counter (high byte) $3B 
Encoded memory state $44 
Accumulator $45 
X register $46 
Y register $47 
Status register $48 


Finally the break routine jumps to the routine whose address is stored at 
$3F0 and $3F1. 


The encoded memory state in location $44 is interpreted as shown in 
Table 6-9. 


Table 6-9. Memory Configuration Information 


Bit 7 = 1 if auxiliary zero page and auxiliary stack are switched in 

Bit 6 = 1 if 830STORE and PAGE2 both on 

Bit5 = 1 if auxiliary RAM switched in for reading 

Bit 4 = 1 if auxiliary RAM switched in for writing 

Bit 38 = 1 if bank-switched RAM being read 

Bit 2 = | if bank-switched $D000 Page 1 switched in and RAMREAD set 
Bit 1 = ] if bank-switched $D000 Page 2 switched in and RAMREAD set 
Bit 0 = 1 if internal Cs ROM was switched in (Ile only) 
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Interrupt Differences: Apple lle Versus Apple Ilc 
A oe vn ie Ba Oks ie Sg A ee SE a 


If you are writing software for both the Apple Ile and the Apple IIc, you 
should know that there are several important differences between the 
interrupts on the enhanced Apple Ile and those on the Apple IIc. They are 


O 


In the IIc ROM, $FFFE points to $C803; in the IIe ROM, to $C3FA. To 
ensure that the proper interrupt vectors are placed into the Language 
Card RAM space, always copy them to the RAM from the ROM. (When 
you initialize built-in devices on the IIc, these vectors are automatically 
updated). 

There is no shared $C800 ROM in the IIc. Peripheral cards share this 
space in the Ile. Thus it is crucial that the slot address of the peripheral 
card using the $C800 space is stored in MSLOT ($07F8). When the 
interrupt handler goes to the internal $C3 space, the IIe hardware 
switches in its own $C800 space. When the interrupt handler finishes, it 
restores the $C800 space to the slot whose address is in MSLOT. 


The IIc $C800 space is always switched in. The enhanced Ile’s interrupt 
handler preserves the state of the $C800-space switch and then switches 

in the slot I/O space. This means that when restoring the state of the 
system using the value placed in location $44, break handling routines must 
restore one more value on the Apple Ile than on the Apple IIc. 


Chapter 6: Programming for Peripheral Cards 


Chapter 7 Hardware Implementation 


Most of this manual describes functions—what the Apple Ile does. This 
chapter, on the other hand, describes objects: the pieces of hardware the 
Apple Ile uses to carry out its functions. If you are designing a piece of 
peripheral hardware to attach to the Apple Ile, or if you just want to know 
more about how the Apple Ile is built, you should study this chapter. 


Environmental Specifications 
ee ee eee eee a a ae See 

The Apple Ile is quite sturdy when used in the way it was intend ed. 

Table 7-1 defines the conditions under which the Apple Ile is designed to 

function properly. 


Table 7-1. Summary of Environmental Specifications 
Operating Temperature: 0° to 45° C (80° to 115° F) 
Relative Humidity: 5% to 85% 

Line Voltage: 107 to 182 VAC 


You should treat the Apple Ile with the same kind of care as any other 
electrical appliance. You should protect it from physical violence, such as 
hammer blows or defenestration. You should protect the mechanical 
keyboard and the electrical connectors inside the case from spilled liquids, 
especially those with dissolved contaminants, such as coffee and cola 
drinks. 


In normal operation, enough air flows through the slots in the cas e to keep 
the insides from getting too hot, although some of the parts inside the 
Apple Ile normally get rather warm to the touch. If you manage to overheat 
your Apple Ile, by blocking the ventilation slots in the top and bottom for 
example, the first symptom will be erratic operation. The memory devices 
in the Apple Ile are sensitive to heat: when they get too hot, they 
occasionally change a bit of data. The exact result depends on what kind of 
program you are running and on just which bit of memory is affected. 
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The Power Supply 
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The power supply in the Apple Ile operates on normal household AC power 
and provides enough low-voltage electrical power for the built-in electronics 
plus a full complement of peripheral cards, including disk controller cards 
and communications interfaces. The basic specifications of the power 
supply are listed in Table 7-2. 


The Apple Ile’s power cord should be plugged into a three-wire 110- to 
120-volt outlet. You must connect the Apple Ile to a grounded outlet or to a 
good earth ground. Also, the line voltage must be in the range given in 
Table 7-2. If you try to operate the Apple Ile from a power source with more 
than 140 volts, you will damage the power supply. 


Table 7-2. Power Supply Specifications 


Line voltage: 107V to 182V AC 
Maximum power consumption: 60W continuous 
80W intermittent* 
Supply voltages: +5V +3% 
+11.8V +6% 
-5.2V + 10% 
-12V + 10% 
Maximum supply currents: +5V: 2.5A 


+12V: 1.5A continuous, 
2.5A intermittent* 

-5V: 250mA 

-12V: 250mA 


Maximum case temperature: 55° C (130° F) 


* Intermittent operation: The Apple Ile can safely operate for up to twenty minutes at the 
higher load if followed by at least ten minutes at normal load. 
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The Apple Ile uses a custom-designed switching-type power supply. It is 
small and lightweight, and it generates less heat than other types of power 
supplies do. 


The Apple Ile’s power supply works by converting the AC line voltage to DC 
and using this DC voltage to power a variable-frequency oscillator. The 
oscillator drives a small transformer with many separate windings to 
produce the different voltages required. A circuit compares the voltage of 
the +5-volt supply with a reference voltage and feeds an error signal back 
to the oscillator circuit. The oscillator circuit uses the error signal to control 
the frequency of its oscillation and keep the output voltages in their normal 
ranges. 


The power supply includes circuitry to protect itself and the other 
electronic parts of the Apple Ie by turning off all four supply voltages 
whenever it detects one of the following malfunctions: 


O any supply voltage short-circuited to ground 
oO the power-supply cable disconnected 
O any supply voltage outside the normal range 


Any time one of these malfunctions occurs, the protection circuit stops the 
oscillator, and all the output voltages drop to zero. After about half a second, 
the oscillator starts up again. If the malfunction is still occurring, the 
protection circuit stops the oscillator again. The power supply will continue 
to start and stop this way until the malfunction is corrected or the power is 
turned off. 


If you think the power supply is broken, do not attempt to repair it 
yourself. The power supply is in a sealed enclosure because some of its 
circuits are connected directly to the power line. Special equipment is 
needed to repair the power supply safely, so see your authorized Apple 
dealer for service. 
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The Power Connector 
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The cable from the power supply is connected to the main circuit board by a 
six-pin connector with a strain-relief catch. The connector pins are 
identified in Table 7-3 and Figure 7-18d. 


Table 7-3. Power Connector Signal Specifications 


PinNumber Name Description 

12 Ground Common electrical ground 
3 +5V +5V from power supply 

4 +12V +12V from power supply 
D -12V -12V from power supply 

6 -\V -5V from power supply 


The 65C02 Microprocessor 
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See Appendix A for a Cescription of the 
65C02’s instruction set and electrical 
characteristics. 


The enhanced Apple Ile uses a 65C02 microprocessor as its central 
processing unit (CPU). The 65C02 in the Apple Ile runs at a clock rate of 
1.023 MHz and performs up to 500,000 eight-bit operations per second. You 
should not use the clock rate as a criterion for comparing different types of 
microprocessors. The 65C02 has a simpler instruction cycle than most other 
microprocessors and it uses instruction pipelining for faster processing. The 
speed of the 65C02 with a 1MHz clock is equivalent to other types of 
microprocessors with clock rates up to 2.65MHz. 


The 65C02 has a sixteen-bit address bus, giving it an address space of 64K 
(2 to the sixteenth power or 65536) bytes. The Apple Ile uses special 
techniques to address a total of more than 64K: see the sections 
“Bank-Switched Memory” and “Auxiliary Memory and Firmware’ in 
Chapter 4 and the section “Switching I/O Memory” in Chapter 6. 
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Table 7-4. 65C02 Microprocessor Specifications 
Type: 65C02 


Register Complement: 8-bit Accumulator (A) 
8-bit Index Registers (X,Y) 
8-bit Stack Pointer (S) 
8-bit Processor Status (P) 
16-bit Program Counter (PC) 


Data Bus: Eight bits wide 
Address Bus: Sixteen bits wide 
Address Range: 65,536 (64K) 
Interrupts: IRQ (maskable) 
NMI (non-maskable) 
BRK (programmed) 
Operating Voltage: +5V (+ 5%) 
Power Dissipation: 5 mW (at 1 MHz) 


65C02 Timing 
————E—SSS 


The operation of the Apple Ile is controlled by a set of synchronous timing 
signals, sometimes called clock signals. In electronics, the word clock is 
used to identify signals that control the timing of circuit operations. The 
Apple Ile doesn’t contain the kind of clock you tell time by, although its 
internal timing is accurate enough that a program running on the Apple Ile 
can simulate such a clock. 


The frequency of the oscillator that generates the master timing signal is 
14.381818 MHz. Circuitry in the Apple Ile uses this clock signal, called 14M, 
to produce all the other timing signals. These timing signals perform two 
major tasks: controlling the computing functions, and generating the video 
display. The timing signals directly involved with the operation of the 
65C02 (and 6502 on the original version of the Apple Ile) are described in 
this section. Other timing signals are described in this chapter in the 
sections “RAM Addressing,” “Video Display Modes,” and “The Expansion 
Slots.” 


The main 65C02 timing signals are listed in Table 7-5, and their 
relationships are diagrammed in Figure 7-1. The 65C02 clock signals are 1 
and $0, complementary signals at a frequency of 1.02273 MHz. The 

Apple Ile signal named ¢0 is equivalent to the signal called @2 in the 
hardware manual. (It isn’t identical: it’s a few nanoseconds early. ) 
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Table 7-5. 65C02 Timing Signal Descriptions 


Signal 

Name Description 

14M Master oscillator, 14.318 MHz; also 80-column dot clock 

VID7M Intermediate timing signal and 40-column dot clock 

Q3 Intermediate timing signal, 2.045 MHz with asymmetrical duty 
cycle 

0 Phase 0 of 65002 clock, 1.0227 MHz; complement of ¢1 

gl Phase 1 of 65C02 clock, 1.0227 MHz; complement of ¢0 


Figure 7-1. 65C02 Timing Signals 
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The operations of the 65C02 are related to the clock signals in a simple way: 
address during $1, data during ¢0. The 65C02 puts an address on the 
address bus during $1. This address is valid not later than 140 nanoseconds 
after @1 goes high and remains valid through all of 60. The 65C02 reads or 
writes data during ¢0. If the 65C02 is writing, the read/write signal is low 
during 0 and the 65C02 puts data on the data bus. The data is valid not 
later than 75 nanoseconds after ¢0 goes high. If the 65C02 is reading, the 
read/write signal remains high. Data on the data bus must be valid no later 
than 50 nanoseconds before the end of ¢0. 


The Custom Integrated Circuits 
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Most of the circuitry that controls memory and I/O addressing in the 

Apple Ile is in three custom integrated circuits called the Memory 
Management Unit (MMU), the Input/Output Unit (JOU), and the 
Programmed Array Logic device (PAL). The soft switches used for 
controlling the various I/O and addressing modes of the Apple Ile are 
addressable flags inside the MMU and the IOU. The functions of these two 
devices are not as independent as their names suggest; working together, 
they generate all of the addressing signals. For example, the MMU generates 
the address signals for the CPU, while the IOU generates similar address 
signals for the video display. 


The Memory Management Unit 
SSS ee ee ee ee) 


The circuitry inside the MMU implements these soft switches, which are 
described in the indicated chapters in this manual: 


Page 2 display (PAGE2): Chapter 2 

High resolution mode (HIRES): Chapter 2 

Store to 80-column card (80STORE): Chapter 2 
Select bank 2: Chapter 4 

Enable bank-switched RAM: Chapter 4 

Read auxiliary memory (RAMRD): Chapter 4 

Write auxiliary memory (RAMWRT): Chapter 4 
Auxiliary stack and zero page (ALTZP): Chapter 4 
Slot ROM for connector #3 (SLOTC38ROM): Chapter 6 
Slot ROM in I/O space (SLOTCXROM): Chapter 6 


O 
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Figure 7-2. The MMU Pinouts 
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The 64K dynamic RAMs used in the Apple Ile use a multiplexed address, as 
described later in this chapter in the section “Dynamic-RAM Timing.” The 
MMU generates this multiplexed address for memory reading and writing 
by the 65C02 CPU. The pinouts and signal descriptions of the MMU are 
shown in Figure 7-2 and Table 7-6. 


Table 7-6. The MMU Signal Descriptions 


Pin 
Number 


The Custom Integrated Circuits 


ROMEN2’ 
ROMEN]’ 
MD7 
RW’245 
RAMEN’ 
CXXxx 
+5V 
Al5-Al 


Description 


Power and signal common 

65C02 address input 

Clock phase 0 input 

Timing signal input 

Memory row-address strobe 
Multiplexed address output 

65C02 read-write control signal 
Inhibits main memory (tied to +5 V) 
Controls data bus for DMA transfers 
Enables auxiliary RAM 

Enables keyboard data bits 0-6 
Enables ROM (tied to ROMEN1’) 
Enables ROM (tied to ROMEN2’) 
State of MMU flags on data bus bit 7 
Controls 74LS245 data-bus buffer 
Enables main RAM 

Enables peripheral-card memory 
Power 

65C02 address input 
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The Input/Output Unit 


Ee a ee ee eel 
The circuitry inside the Input/Output Unit (JOU) implements the following 
soft switches, all described in Chapter 2 in this manual: 


Page 2 display (PAGE2) 

High resolution mode (HIRES) 

Text mode (TEXT) 

Mixed mode (MIXED) 

80-column display (80COL) 

Text display mode select (ALTCHAR) 
Any-key-down 

Annunciators 

Vertical blanking (VBL) 


The 64K dynamic RAMs used in the Apple Ile require a multiplexed 
address, as described later in this chapter in the section “Dynamic-RAM 
Timing.” The IOU generates this multiplexed address for the data transfers 
required for display and memory refresh during clock phase 1. The way this 
address is generated is described later in this chapter in the section “Display 
Address Mapping.” The pinouts and signal descriptions for the IOU are 
shown in Figure 7-3 and Table 7-7. 
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Figure 7-3. The IOU Pinouts 
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Table 7-7. The IOU Signal Descriptions 


Pin 
Number 
] 


2 
3 
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80VID’ 
CASSO 
SPKR 
MD7 
ANO-AN3 
R/W’ 
RESET’ 


RAO-RA7 
PRAS’ 


KSTRB 


Description 


Power and signal common 

Graphics mode enable 

In text mode, works with VC (see pin 5) and SEGB 
to determine character row address 

In text mode, works with VC (see pin 5) and SEGA; 
in graphics mode, selects high-resolution when low, 
low-resolution when high 

Display vertical counter bit: in text mode, SEGA, 
SEGB and VC determine which of the eight rows of 
a character’s dot pattern to display; in 
low-resolution, selects upper or lower block defined 
by a byte. 

80-column video enable 

Cassette output signal 

Speaker output signal 

Internal IOU flags for data bus (bit 7)3 
Annunciator outputs 

65C02 read-write control signal 

Power on and reset output 

Nothing is connected to this pin. 

Video refresh multiplexed RAM address (phase 1) 
Row-address strobe (phase 0) 

Master clock phase 0 

Intermediate timing signal 

Power 

Address bit 6 from 65C02 

1/0 address enable 

Any-key-down signal 

Keyboard strobe signal 

Video display data bits 

Video display control bits 

Color-burst gate (enable) 

Display blanking signal 

Display synchronization signal 

Display horizontal timing signal (low bit of 
character counter) 
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Figure 7-4. The PAL Pinouts 


The PAL Device 
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A Programmed Array Logic device, type PAL 16R8, generates several timing 
and control signals in the Apple Ile. These signals are listed in Table 7-8. 
The PAL pinouts are given in Figure 7-4. 


Table 7-8. The PAL Signal Descriptions 


] 
2 
3 
4 
5 
6 
7 
8 
) 
0 
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Pin 

Number Name Description 

1 14M 14.31818 MHz master timing signal 
2 7M 7.15909 MHz timing signal 

3 3.58M 3.579545 MHz timing signal 

4 HO Horizontal video timing signal 
VID7 Video data bit 7 

6 SEGB Video timing signal 

7 GR Video display graphics-mode enable 
8 RAMEN’ RAM enable (CAS enable) 

9 80VID’ Enable 80-column display mode 

10 GND Power and signal common 

11 ENTMG Enable master timing 

12 LDPS’ Video shift-register load enable 

13 VID7M Video dot clock, 7 or 14 MHz 

14 ol Phase 1 system clock 

15 b0 Phase 0 system clock 

16 Q3 Intermediate timing and strobe signal 
17 PCAS’ RAM column-address strobe 

18 N.C. (This pin is not used. ) 

19 PRAS’ RAM row-address strobe 

20) +5V Power 


Memory Addressing 


The Apple Ile’s microprocessor can address 65,536 locations. The Apple Ile 
uses this entire address space, and then some: some areas in memory are 
used for more than one function. The following sections describe t he 
memory devices used in the Apple Ile and the way they are addressed. 
Input and output also use portions of the memory address space; refer to the 
section “Peripheral-Card Memory Spaces” in Chapter 6 for information. 
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Figure 7-5. The 2364 ROM Pinouts ROM Addressing 
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In the Apple Ile, the following programs are permanently stored in two type 


ve ey 2364 8K by 7-bit ROMs (read-only memory): 
AT BV oO Applesoft editor and interpreter 
: ie o System Monitor 
A4 All oO 80-column display firmware 
2 oo Oo self-test routines 
Al Ck’ These two ROMs are enabled by two signals called ROMEN] and ROMENZ. 
AO MD? The ROM enabled by ROMEN1, sometimes called the Diagnostics ROM, 
one “e occupies the memory address space from $C100 to $DFFF. The address 
MD? MD4 space from $C300 to $C3FF and from $C800 to $CFFF contains the 
GND MD3 80-column display firmware. Those address spaces are normally assigned to 


ROM on a peripheral card in slot 3; for a discussion of the way the 
80-column firmware overrides the peripheral card, see the section “Other 
Uses of 1/0 Memory Space” in Chapter 6. The pinouts of the 2864 ROMs are 
given in Figure 7-5. 


Two other portions of the Diagnostics ROM, addressed from $C100 to $C2FF 
and from $C400 to $C7FF, contain the built-in self-test routines. These 
address spaces are normally assigned to the peripheral cards; when the 
self-test programs are running, the peripheral cards are disabled. 


The remainder of the Diagnostics ROM, addressed from $D000 to $DFFF, 
contains part of the Applesoft BASIC interpreter. 


The ROM enabled by ROMEN2, sometimes called the Monitor ROM, 
occupies the memory address space from $E000 to $FFFF. This ROM 
contains the rest of the Applesoft interpreter, in the address space from 
$E000 to $EFFF, and the Monitor subroutines, from $F000 to $FFFF. 


The other ROMs in the Apple IIe are a type 2316 ROM used for the keyboard 
character decoder and a type 2333 ROM used for character sets for the video 
display. This 2833 ROM is rather large because it includes a section of 
straight-through bit-mapping for the graphics modes. This way, graphics 
display video can pass through the same circuits as text without additional 
switching circuitry. The 2316's pinout is given in Figure 7-6, and the 2333's 
pinout is given in Figure 7-7. 
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Figure 7-8. The 64K RAM Pinouts 
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RAM Addressing 
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The RAM (programmable) memory in the Apple Ile is used both for program 
and data storage and for the video display. The areas in RAM that are used 
for the display are accessed both by the 65C02 microprocessor and by the 
video display circuits. In some computers, this dual access results in 
addressing conflicts (cycle stealing) that can cause temporary dropouts in 
the video display. This problem does not occur in the Apple Ile, thanks to 
the way the microprocessor and the video circuits share the memory. 


The memory circuits in the Apple Ile take advantage of the two-phase 
system clock described earlier in this chapter in the section “65C02 Timing” 
to interleave the microprocessor memory accesses and the display memory 
accesses so that they never interfere with each other. The microprocessor 
reads or writes to RAM only during ¢0, and the display circuits read data 
only during ¢l. 


Dynamic-RAM Refreshment 


The image on a video display is not permanent; it fades rapidly and must be 
refreshed periodically. To refresh the video display, the Apple Ile reads the 
data in the active display page and sends it to the display. To prevent 
visible flicker in the display, and to conform to standard practice for 
broadcast video, the Apple Ile refreshes the display sixty times per second. 


The dynamic RAM devices used in the Apple Ile also need a kind of refresh, 
because the data is stored in the form of electric charges which diminish 
with time and must be replenished every so often. The Apple Ile is designed 
so that refreshing the display also refreshes the dynamic RAMs. The next 
few paragraphs explain how this is done. 


The job of refreshing the dynamic RAM devices is minimized by the 
structure of the devices themselves. The individual data cells in each RAM 
device are arranged in a rectangular array of rows and columns. When the 
device is addressed, the part of the address that specifies a row is presented 
first, followed by the address of the column. Splitting information into parts 
that follow each other in time is called multiplexing. Since only half of the 
address is needed at one time, multiplexing the address reduces the number 
of pins needed for connecting the RAMs. 


Different manufacturers’ 64K RAMs have cell arrays of either 128 rows by 
512 columns or 256 rows by 256 columns. Only the row portion of the 
address is used in refreshing the RAMs. 
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Now consider how the display is refreshed. As described later in this 
chapter in the section “The Video Counters,” the display circuitry generates 
a sequence of 8,192 memory addresses in high-resolution mode; in text and 
low-resolution modes, this sequence is the 1,024 display-page addresses 
repeated eight times. The display address cycles through this sequence 

60 times a second, or once every 17 milliseconds. The way the low-order 
address lines are assigned to the RAMs, the row address cycles through all 
206 possible values once every two milliseconds. (See Figure 7-9.) This 
more than satisfies the refresh requirements of the dynamic RAMs. 


Table 7-9. RAM Address Multiplexing 


Mux’d Row Column 
Address Address Address 
RAO AO AQ 

RAI Al A6 

RA2 A2 Al0 
RA3 A38 All 
RA4 A4 Al2 
RAD Ad Alb 
RA6 A’ Al4 
RA? A8 Ald 


Dynamic-RAM Timing 


The Apple Ile’s microprocessor clock runs at a moderate speed, about 
1.023 MHz, but the interleaving of CPU and display cycles means that the 
RAM is being accessed at a 2 MHz rate, or a cycle time of just under 

500 nanoseconds. Data for the CPU is strobed by the falling edge of ¢0, and 
display data is strobed by the falling edge of #1, as shown in Figure 7-9. 
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Figure 7-9. RAM Timing Signals 
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The RAM timing looks complicated because the RAM address is 
multiplexed, as described in the previous section. The MMU takes care of 
multiplexing the address for the CPU cycle, and the IOU performs the same 
function for the display cycle. The multiplexed address is sent to the RAM 
ICs over the lines labelled RAO-RA7. Along with the other timing signals, the 
PAL device generates two signals that control the RAM addressing: 
row-address strobe (RAS) and column-address strobe (CAS). 


Table 7-10. RAM Timing Signal Descriptions 


Signal Name Description 

g0 Clock phase 0 (CPU phase) 

gl Clock phase 1 (display phase) 

RAS Row-address strobe 

CAS Column-address strobe 

Q3 Alternate RAM/column-address strobe 
RAO-RA7 Multiplexed address bus 

MDO0-MD7 Internal data bus 


The Video Display 
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The Apple Ile produces a video signal that creates a display on a standard 
video monitor or, if you add an RF modulator, on a black-and-white or color 
television set. The video signal is a composite made up of the data that is 
being displayed plus the horizontal and vertical synchronization signals that 
the video monitor uses to arrange the lines of display data on the screen. 


Video Standards: Apple Ile’s manufactured for sale in the U.S. 
generate a video signal that is compatible with the standards set by the 
NTSC (National Television Standards Committee). Apple Ile’s 
manufactured for sale in European countries generate video that is 
compatible with the standard used there, which is called P.A.L. (for 
phase alternating lines). This manual describes only the NTSC version of 
the video circuits. 


The Video Display 173 


The display portion of the video signal is a time-varying voltage g enerated 
from a stream of data bits, where a 1 corresponds to a voltage that generates 
a bright dot, and a 0 to a dark dot. The display bit stream is gener ated in 
bursts that correspond to the horizontal lines of dots on the video screen. 
The signal named WNDW’ is low during these bursts. 


During the time intervals between bursts of data, nothing is displ ayed on 
the screen. During these intervals, called the blanking intervals, the display 
is blank and the WNDW’ signal is high. The synchronization sign als, called 
sync for short, are produced by making the signal named SYNC’ low during 
portions of the blanking intervals. The sync pulses are at a voltage 
equivalent to blacker-than-black video and don’t show on the screen. 


The Video Counters 
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The address and timing signals that control the generation of the video 
display are all derived from a chain of counters inside the IOU. Only a few 
of these counter signals are accessible from outside the IOU, but they are all 
important in understanding the operation of the display generation process, 
particularly the display memory addressing described in the next section. 


The horizontal counter is made up of seven stages: HO, H1, H2, H8, H4, H6, 
and HPE’. The input to the horizontal counter is the 1 MHz signal that 
controls the reading of data being displayed. The complete cycle of the 
horizontal counter consists of 65 states. The six bits HO through H5 count 
normally from 0 to 63, then start over at 0. Whenever this happens, HPE’ 
forces another count with HO through Hd held at zero, thus extending the 
total count to 65. 


The IOU uses the forty horizontal count values from 25 through 64 in 
generating the low-order part of the display data address, as described later 
in this chapter in the section “Display Address Mapping.” The IOU uses the 
count values from 0 to 24 to generate the horizontal blanking, the horizontal 
sync pulse, and the color-burst gate. 
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When the horizontal count gets to 65, it signals the end of a line by 
triggering the vertical counter. The vertical counter has nine stages: VA, 
VB, VG, VO, V1, V2, V8, V4, and V5. When the vertical count reaches 262, 
the IOU resets it and starts counting again from zero. Only the first 192 
scanning lines are actually displayed; the IOU uses the vertical counts from 
192 to 261 to generate the vertical blanking and sync pulse. Nothing is 
displayed during the vertical blanking interval. (The vertical line count is 
262 rather than the standard 262.5 because, unlike normal television, the 
Apple Ile’s video display is not interlaced. ) 


Smooth Animation: Animation displays sometimes have an erratic 
flicker caused by changing the display data at the same time it is being 
displayed. You can avoid this on the Apple Ile by reading the 
vertical-blanking signal (VBL) at location $C019 and changing display 
data while VBL is low only (data value less than 128). 


Display Memory Addressing 
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As described in Chapter 2 in the section “Addressing Display Pages 
Directly,” data bytes are not stored in memory in the same sequence in 
which they appear on the display. You can get an idea of the way the 
display data is stored by using the Monitor to set the display to graphics 
mode, then storing data starting at the beginning of the display page at 
hexadecimal $400 and watching the effect on the display. If you do this, you 
should use the graphics display instead of text to avoid confusion: the text 
display is also used for Monitor input and output. 


If you want your program to display data by storing it directly into the 
display memory, you must first transform the display coordinates into the 
appropriate memory addresses, as shown in the section “Video Display 
Pages” in Chapter 2. The descriptions that follow will help you understand 
how this address transformation is done and why it is necessary. They will 
not (alas!) eliminate that necessity. 


The address transformation that folds three rows of forty display bytes into 
128 contiguous memory locations is the same for all display modes, so it is 
described first. The differences among the different display modes are then 
described in the section “Video Display Modes.” 


The Video Display I%b 


Display Address Mapping 


Consider the simplest display on the Apple Ile, the 40-column text mode. To 
address forty columns requires six bits, and to address twenty-four rows 
requires another five bits, for a total of eleven address bits. Addressing the 
display this way would involve 2048 (2 to the eleventh power) bytes of 
memory to display a mere 960 characters. The 80-column text mode would 
require 4096 bytes to display 1920 characters. The leftover chunks of 
memory that were not displayed could be used for storing other data, but 
not easily, because they would not be contiguous. 


Instead of using the horizontal and vertical counts to address memory 
directly, the circuitry inside the IOU transforms them into the new address 
signals described below. The transformed display address must meet the 
following criteria: 


co Map the 960 bytes of 40-column text into only 1024 bytes. 
The requirements of the RAM refreshing oO Scan the low-order address to refresh the dynamic RAMs. 


are discussed earlier in this chapter inthe + Continue to refresh the RAMs during video blanking. 
section “Dynamic-RAM Refreshment. 


The transformation involves only horizontal counts H3, H4, and Hd, and 
vertical counts V3 and V4. Vertical count bits VA, VB, and VC address the 
lines making up the characters, and are not involved in the address 
transformation. The remaining low-order count bits, H0, H1, H2, ‘V0, V1, and 
V2 are used directly, and are not involved in the transformation. 


The JOU performs an addition that reduces the five significant count bits to 
four new signals called SO, $1, $2, and S38, where S stands for surn. 

Figure 7-10 is a diagram showing the addition in binary form, with V3 
appearing as the carry in and Hd appearing as its complement H5’. 

A constant value of 1 appears as the low-order bit of the addend. The carry 
bit generated with the sum is not used. 


Table 7-11. Display Address Transformation 


V8 Carry in 
Hp: V3 H4 H3 Augend 
V4 H5’ V4 1 Addend 
83 S2 Sl SO Sum 
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If this transformation seems terribly obscure, try it with actual values. For 
example, for the upper-left corner of the display, the vertical count is 0 and 
the horizontal count is 24: HO, H1, H2, and Hd are 0’s and H8, and H4 are 1’s. 
The value of the sum is 0, so the memory location for the first character on 
the display is the first location in the display page, as you might expect. 


Horizontal bits HO, H1, and H2 and sum bits SO, $1, and S2 make up the 
transformed horizontal address (A0 through A6 in Table 7-12). As the 
horizontal count increases from 24 to 63, the value of the sum 

(S3 $2 51 SO) increases from 0 to 4 and the transformed address goes from 0 
to 89, relative to the beginning of the display page. 


The low-order three bits of the vertical row counter are V0, V1, and V2. 
These bits control address bits A7, A8, and A9, as shown in Table 7-12, so 
that rows 0 through 7 start on 127-byte boundaries. When the vertical row 
counter reaches 8, then VO, V1, and V2 are 0 again, and V3 changes to 1. If 
you do the addition in Table 7-11 with H equal to 24 (the horizontal count 
for the first column displayed) and V equal to 8, the sum is 5 and the 
horizontal address is 40: the first character in row 8 is stored in the memory 
location 40 bytes from the beginning of the display page. 


Figure 7-10. 40-Column Text Display Memory 


Memory locations marked with an asterisk (*) are reserved for use by peripheral 
1/0 firmware: refer to the section “Peripheral-Card RAM Space’ in Chapter 6. 


es 128 Byles 


8 


4) Bytes—e | +4 Byes —+| —a Byes |e 


Bytes 
$400 
$480 
$500 
$580 
$600 
$680 
$700 
$780 
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Figure 7-10 shows how groups of three forty-character rows are stored in 
blocks of 120 contiguous bytes starting on 127-byte address boundiaries. 
This diagram is another way of describing the display mapping shaown in 
Figure 2-5. Notice that the three rows in each block of 120 bytes are not 
adjacent on the display. 


Table 7-12 shows how the signals from the video counters are assigned to 
the address lines. HO, H1, and H2 are horizontal-count bits, and VO, V1, and 
V2 are vertical-count bits. SO, $1, S2 and $3 are the folded address bits 
described above. Address bits marked with asterisks (*) are different for 
different modes: see Table 7-13 and the four subsections under th section 
“Video Display Modes.” 


Table 7-12. Display Memory Addressing 


Memory Display Memory Display 
Address Bit Address Bit Address Bit Addres s Bit 
AO HO A8 Vl 

Al H1 A9 V2 

A2 HZ Al0 id 

A3 S50 All = 

A4 51 Al2 

Ad 2 Al3 os 

A6 53 Al4 " 

AZ VO Ald GND 


™ For these address bits, see text and Table 7-18. 


Table 7-13. Memory Address Bits for Display Modes 


_ means logical AND; “means logical NOT. 


Display Modes 
Address Text and High-Resolution and 
Bit Low-Resolution Double-High-Resolution 
Al0 8OSTORE+PAGE2’ VA 
All 8OSTORE’.PAGE2 VB 
Al2 0 VC 
Al3 () 80STORE+PAGE2’ 
Al4 0 80STORE’.PAGE2 
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Video Display Modes 
ee eee ees 


The different display modes all use the address-mapping scheme described 
in the previous section, but they use different-sized memory areas in 
different locations. The next four sections describe the addressing schemes 
and the methods of generating the actual video signals for the different 
display modes. 


Text Displays 


The text and low-resolution graphics pages begin at memory locations 
$0400 and $0800. Table 7-13 shows how the display-mode signals control 
the address bits to produce these addresses. Address bits Al0 and All are 
controlled by the settings of PG2 and 80STORE, which are set by the 
display-page and 80-column-video soft switches. Address bits Al2, A138, and 
Al4 are set to 0. Notice that 80STORE active inhibits PG2: there is only one 
display page in 80-column mode. 


The bit patterns used for generating the different characters are stored in a 
32K ROM. The low-order six bits of each data byte reach the character 
generator ROM directly, via the video data bus VIDO-VID5. The two 
high-order bits are modified by the IOU to select between the primary and 
alternate character sets and are sent to the character generator ROM on 
lines RAY and RA1O. 


The data for each row of characters are read eight times, once for each of 
the eight lines of dots making up the row of characters. The data bits are 
sent to the character generator ROM along with VA, VB, and VC, the 
low-order bits from the vertical counter. For each character being displayed, 
the character generator ROM puts out one of eight stored bit patterns 
selected by the three-bit number made up of VA, VB, and VC. 


The bit patterns from the character generator ROM are loaded into the 
74166 parallel-to-serial shift register and output as a serial bit stream that 
goes to the video output circuit. The shift register is controlled by signals 
named LDPS’ (for load parallel-to-serial shifter) and VID7M (for video 

7 MHz). In 40-column mode, LDPS’ strobes the output of the character 
generator ROM into the shift register once each microsecond, and bits are 
sent to the screen at a 7 MHz rate. 
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The addressing for the 80-column display is exactly the same as for the 
40-column display: the 40 columns of display memory on the 80-column 
card are addressed in parallel with the 40 columns in main memory. The 
data from these two memories reach the video data bus (lines VID0-VID7) 
via separate 74LS374 three-state buffers. These buffers are loaded 
simultaneously, but their outputs are sent to the character generator ROM 
alternately by ¢0 and @1. In 80-column mode, LDPS’ loads data from the 
character generator ROM into the shift register twice during each 
microsecond, once during $0 and once during ¢1, and bits are sent to the 
screen at a 14 MHz rate. Figures 7-11a and 7-11b show the video timing 
signals. 


Figure 7-1la. 7 MHz Video Timing Signals 
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Figure 7-11b. 14 MHz Video Timing Signals 
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Low-Resolution Display 


In the graphics modes, VA and VB are not used by the character generator, 
so the IOU uses lines SEGA and SEGB to transmit HO and HIRES’, as shown 
in Table 7-14. 


Table 7-14. Character-Generator Control Signals 


Display 

Mode SEGA SEGB SEGC 
Text VA VB VC 
Graphics _H0 HIRES’ VC 


The low-resolution graphics display uses VC to divide the eight display lines 
corresponding to a row of characters into two groups of four lines each. 
Each row of data bytes is addressed eight times, the same as in text mode, 
but each byte is interpreted as two nibbles. Each nibble selects one of 16 
colors. During the upper four of the eight display lines, VC is low and the 
low-order nibble determines the color. During the lower four dispLay lines, 
VC is high and the high-order nibble determines the color. 


The bit patterns that produce the low-resolution colors are read from the 
character-generator ROM in the same way the bit patterns for characters 
are produced in text mode. The 74166 parallel-to-serial shift register 
converts the bit patterns to a serial bit stream for the video circuits. 


The video signal generated by the Apple Ile includes a short burst of 

3.08 MHz signal that is used by an NTSC color monitor or color TV set to 
generate a reference 3.58 MHz color signal. The Apple IIe’s video signal 
produces color by interacting with this 3.58 MHz signal inside the monitor or 
TV set. Different bit patterns produce different colors by changing the duty 
cycles and delays of the bit stream relative to the 3.58 MHz color signal. To 
produce the small delays required for so many different colors, the shift 
register runs at 14 MHz and shifts out 14 bits during each cycle of the 1-MHz 
data clock. To generate a stream of fourteen bits from each eight-bit pattern 
read from the ROM, the output of the shift register is connected back to the 
register’s serial input to repeat the same eight bits; the last two bits are 
ignored the second time around. 
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Each bit pattern is output for the same amount of time as a character: .98 
microseconds. Because that is exactly enough time for three and a half 
cycles of the 3.58 MHz color signal, the phase relationship between the bit 
patterns and the signal changes by a half cycle for each successive pattern. 
To compensate for this, the character generator ROM puts out one of two 
different bit patterns for each nibble, depending on the state of HO, the 
low-order bit of the horizontal counter. 


High-Resolution Display 


The high-resolution graphics pages begin at memory locations $2000 and 
$4000 (decimal 8192 and 16384). These page addresses are selected by 
address bits Al3 and A14. In high-resolution mode, these address bits are 
controlled by PG2 and 80STORE, the signals controlled by the display-page 
(PAGE2) and 80-column-video (80COL) soft switches. As in text mode, 
8OSTORE inhibits addressing of the second page because there is only one 
page of 80-column text available for mixed mode. 


In high-resolution graphics mode, the display data are still stored in blocks 
like the one shown in Figure 7-10, but there are eight of these blocks. As 
Table 7-12 and Table 7-13 show, vertical counts VA, VB, and VC are used 
for address bits A10, All, and Al2, which address eight blocks of 1024 bytes 
each. Remember that in the display, VA, VB, and VC count adjacent 
horizontal lines in groups of eight. This addressing scheme maps each of 
those lines into a different 1024-byte block. It might help to think of it as a 
kind of eight-way multiplexer: it’s as if eight text displays were combined to 
produce a single high-resolution display, with each text display providing 
one line of dots in turn, instead of a row of characters. 


The high-resolution bit patterns are produced by the character-generator 
ROM. In this mode, the bit patterns simply reproduce the eight bits of 
display data. The low-order six bits of data reach the ROM via the video 
data bus VIDO-VID5. The IOU sends the other two data bits to the ROM via 
RAQ and RA10. 


The high-resolution colors described in Chapter 2 are produced by the 
interaction between the video signal the bit patterns generate and the 

3.58 MHz color signal generated inside the monitor or TV set. The 
high-resolution bit patterns are always shifted out at 7 MHz, so each dot 
corresponds to a half-cycle of the 3.58 MHz color signal. Any part of the 
video signal that produces a single white dot between two black dots, or 
vice versa, is effectively a short burst of 3.58 MHz and is therefore displayed 
as color. In other words, a bit pattern consisting of alternating 1’s and 0's 
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gets displayed as a line of color. The high-resolution graphics subroutines 
produce the appropriate bit patterns by masking the data bits with 
alternating 1’s and 0’s. 


To produce different colors, the bit patterns must have different phase 
relationships to the 3.58 MHz color signal. If alternating 1’s and 0’s produce 
a certain color, say green, then reversing the pattern to 0’s and 1’s will 
produce the complementary color, purple. As in the low-resolution mode, 
each bit pattern corresponds to three and a half cycles of the color signal, so 
the phase relationship between the data bits and the color signal changes by 
a half cycle for each successive byte of data. Here, however, the bit patterns 
produced by the hardware are the same for adjacent bytes; the color 
compensation is performed by the high-resolution software, which uses 
different color masks for data being displayed in even and odd columns. 


To produce other colors, bit patterns must have other timing relationships 
to the 8.58 MHz color signal. In high-resolution mode, the Apple Ile produces 
two more colors by delaying the output of the shift register by half a dot 

(70 ns), depending on the high-order bit of the data byte being displayed. 
(The high-order bit doesn't actually get displayed as a dot, because at 7 MHz 
there is only time to shift out seven of the eight bits. ) 


As each byte of data is sent from the character generator to the shift 
register, high-order data bit D7 is also sent to the PAL device. If D’7 is off, the 
PAL device transmits shift-register timing signals LDPS’ and VID‘7M 
normally. If D7 is on, the PAL device delays LDPS’ and VID7M by 70 
nanoseconds, the time corresponding to half a dot. The bit patterm that 
formerly produced green now produces orange; the pattern for purple now 
produces blue. 


A Note About Timing: For 80-column text, the shift register is clocked 
at twice normal speed. When 80-column text is used with graphics in 
mixed mode, the PAL device controls shift-register timing signa ls LDPS’ 
and VID7M so that the graphics portion of the display works correctly 
even when the text window is in 80-column mode. 
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Double-High-Resolution Display 


Double-high-resolution graphics mode displays two bytes in the time 
normally required for one, but uses high-resolution graphics Page 1 in both 
main and auxiliary memory instead of text or low-resolution Page 1. 


Note: There is a second pair of pages, high-resolution Page 2, which can 
be used to display a second double-high-resolution page. 


Double-high-resolution graphics mode displays each pair of data bytes as 14 
adjacent dots, seven from each byte. The high-order bit (color-select bit) of 
each byte is ignored. The auxiliary-memory byte is displayed first, so data 
from auxiliary memory appears in columns 0-6, 14-20, and so on, up to 
columns 547-552. Data from main memory appears in columns 7-18, 21-27, 
and so on, up to 553-559. 


As in 80-column text, there are twice as many dots across the display 
screen, so the dots are only half as wide. On a TV set or low-bandwidth 
monitor (less than 14 MHz), single dots will be dimmer than normal. 


Note: Except for some expensive RGB-type monitors, any video monitor 
with a bandwidth as high as 14 MHz will be a monochrome monitor. 
Monochrome means one color: a monochrome video monitor can have a 
screen color of white, green, orange, or any other single color. 


The main memory and auxiliary memory are connected to the address bus 
in parallel, so both are activated during the display cycle. The rising edge of 
#0 clocks a byte of main memory data into the video latch, and a byte of 
auxiliary memory data into the 80 latch. 


Phi 1 (¢1) enables output from the (auxiliary) 80 latch, and 0 enables 
output from the (main) video latch. Output from both latches goes to 
CHARGEN, where GR and SEGB’ select high-resolution graphics. LDPS 
operates at 2 MHz in this mode, alternately gating the auxiliary byte and 
main byte into the parallel-to-serial shift register. VID7M is active (kept 
true) for double-high-resolution display mode, so when it is ANDed with 
14M, the result is still 14M. The 14M serial clock signal gate shift register 
then outputs to VID, the video display hybrid circuit, for output to the 
display device. 
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Video Output Signals 


i = ee ee eee 
The stream of video data generated by the display circuits described above 
goes to a linear summing circuit built around transistor Q1 where it is mixed 
with the sync signals and the color burst. Resistors R8, Rd, R7, R10, R18, 
and R15 adjust the signals to the proper amplitudes, and a tank circuit (L3 
and C32) resonant at 3.58 MHz conditions the color burst. 


The resulting video signal is an NTSC-compatible composite-video signal 
that can be displayed on a standard video monitor. The signal is similar to 
the EIA (Electronic Industries Association) standard positive composite 
video (see Table 7-15). This signal is available in two places in the Apple Ile: 


oO At the phono jack on the back of the Apple Ile. The sleeve of this jack is 
connected to ground and the tip is connected to the video output through 
a resistor network that attenuates it to about 1 volt and matches its 
impedance to 75 ohms. 

oO At the internal video connector on the Apple Ile circuit board near the 
RCA jack, J13 in Figure 7-18c. It is made up of four Molex-type pins, 
().25 inches tall, on 0.10 inch centers. This connector carries the video 
signal, ground, and two power supplies, as shown in Table 7-15. 


Table 7-15. Internal Video Connector Signals 
Note: Pin 1 is the pin closest to the keyboard, pin 4 is at the back. 


Pin Name Description 
I GROUND System common ground 
Z VIDEO NTSC-compatible positive composite video. White 


level is about 2.0 volts, black level is about 0.75 
volts, and sync level is 0.0 volts. This output is not 
protected against short-circuits. 


3 -5V -5 volt power supply 
4 +12V +12 volt power supply 
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Built-in 1/O Circuits 

a a a a a a DL a ee ean a eee 
The use of the Apple Ile’s built-in 1/0 features is described in Chapter 2. 
This section describes the hardware implementation of all of those features 
except the video display described in the previous sections. 


The IOU (Input/Output Unit) directly generates the output signals for the 
speaker, the cassette interface, and the annunciators. The other I/O 
features are handled by smaller [Cs, as described later in this section. 


The addresses of the built-in 1/0 features are described in Chapter 2 and 
listed in Table 2-2, Table 2-11, and Table 2-12. All of the built-in I/O 
features except the displays use memory locations between $C000 and 
$C070 (decimal 49152 and 49264). The I/O address decoding is performed 
by three ICs: a 74LS188, a 74LS154, and a 74L8251. 


The 74LS138 decodes address lines A8, AY, Al0, and A1] to select address 
pages on 256-byte boundaries starting at $C000 (decimal 49152). When it 
detects addresses between $C000 and $COFF, it enables the IOU and the 
74LS154. The 74LS154 in turn decodes address lines A4, Ad, A6, and A7 to 
select 16-byte address areas between $C000 and $COFF. Addresses between 
$0060 and $CO6F enable the 74LS251 that multiplexes the hand control 
switches and paddles; addresses between $C070 and $CO7F reset the NE558 
quadruple timer that interfaces to the hand controls, as described later in 
the section “Game I/O Signals.” 


The Keyboard 


SSS Sa 

The Apple Ile’s keyboard is a matrix of keyswitches connected to an 
AY-3600-type keyboard decoder via a ribbon cable and a 26-pin connector. 
The AY-3600 scans the array of keys over and over to detect any keys 
pressed. The scanning rate is set by the external resistor-capacitor network 
made up of C70 and R82. The debounce time is also set externally, by C71. 


The AY-3600’s outputs include five bits of key code plus separate lines for 
(CONTROL ], (SHIFT ], any-key-down, and keyboard strobe. The 
any-key-down and keyboard-strobe lines are connected to the IOU, which 
addresses them as soft switches. The key-code lines, along with 
and [SHIFT ], are inputs to a separate 2316 ROM. The ROM translates them 
to the character codes that are enabled onto the data bus by signals named 
KBD’ and ENKBD’. The KBD’ signal is enabled by the MMU whenever a 
program reads location $C000, as described in the section “Reading the 
Keyboard” in Chapter 2. 
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Table 7-16. Keyboard Connector Signals 


PinNumber Name Description 

1,2,4,6,8, 10, Y0-Y9 Y-direction key-matrix connections 
23,20,12,22 

3 +5 +5 volt supply 

5,7,9,15 nc. 

l LCNTL’ Line from key 

13 GND System common ground 
14,16,20,21, § X0-X7 X-direction key-matrix connections 
19,26,17 

24 LSHFT’ Line from key 


Connecting a Keypad 


There is a smaller connector wired in parallel with the keyboard connector. 
You can connect a ten-key numeric pad to the Apple Ile via this c onnector. 


Table 7-17. Keypad Connector Signals 


PinNumber Name Description 

1,2,5,3,4,6 Y0-Y5 Y-direction key-matrix connections 
(i nc. 

911,108 X4-X7 X-direction key-matrix connections 
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Cassette !|/O 


The two miniature phone jacks on the back of the Apple Ile are used to 
connect an audio cassette recorder for saving programs. The output signal 
to the cassette recorder comes from a pin on the IOU via resistor network R6 
and R9, which attenuates the signal to a level appropriate for the recorder’s 
microphone input. Input from the recorder is amplified and conditioned by a 
type 741 operational amplifier and sent to one of the inputs of the 74LS251 
input multiplexer. 


The signal specifications for cassette I/O are 


oO Input: 1 volt (nominal) from recorder earphone or monitor output. Input 
impedance is 12K ohms. 


O Output: 25 millivolts to recorder microphone input. Output impedance is 
100 ohms. 


The Speaker 


a a) 

The Apple [le’s built-in loudspeaker is controlled by a single bit of output 
from the IOU (Input Output Unit). The signal from the IOU is AC coupled to 
Q5, an MPSA18 Darlington transistor amplifier. The speaker connector is a 
Molex KK100 connector, J18 in Figure 7-18b, with two square pins 0.25 
inches tall and on 0.10-inch centers. 


A light-emitting diode is connected in parallel across the speaker pins such 
that, when the speaker is not connected, the diode glows whenever the 
speaker signal is on. This diode is used as a diagnostic indicator during 
assembly and testing of the Apple Ile. 


Table 7-18. Speaker Connector Signals 


Pin 
Number Name Description 
1 SPKR Speaker signal. This line will deliver about 
0.5 watts into an 8-ohm speaker. 
2 +5 +5V power supply. Note that the speaker is not 


connected to system ground. 
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Game |/O Signals 


ie ae ee ee ee as | 

Several I/O signals that are individually controlled via soft switches are 
collectively referred to as the game signals. Even though they are normally 
used for hand controls, these signals can be used for other simple I/O 
applications. There are five output signals: the four annunciators, 
numbered AO through A38, and one strobe output. There are three one-bit 
inputs, called swztches and numbered SWO through SW2, and four analog 
inputs, called paddles and numbered PDLO through PDL38. 


The annunciator outputs are driven directly by the IOU (Input Output Unit). 
These outputs can drive one TTL (transitor-transitor logic) load each; for 
heavier loads, you must use a transistor or a TTL buffer on these outputs. 
These signals are only available on the 16-pin internal connector. (See 
Table 7-19.) 


The strobe output is a pulse transmitted any time a program reads or writes 
to location $C040. The strobe pin is connected to one output of the 74LS154 
address decoder. This TTL signal is normally high; it goes low during ¢0 of 
the instruction cycle that addresses location $C040. This signal is only 
available on the 16-pin internal connector. (See Table 7-19.) 


The game inputs are multiplexed along with the cassette input signal by a 
74LS251 eight-input multiplexer enabled by the C06X’ signal from the 
74LS154 1/0 address decoder. Depending on the low-order address, the 
appropriate game input is connected to bit 7 of the data bus. 


The switch inputs are standard low-power Schottky TTL inputs. To use 
them, connect each one to 560-ohm pull-down resistors connected to the 
ground and through single-pole, momentary-contact pushbutton switches to 
the +5 volt supply. 


The hand-control inputs are connected to the timing inputs of an NE558 
quadruple 555-type analog timer. Addressing $C0O7X sends a signal from the 
74LS154 that resets all four timers and causes their outputs to go to 

1 (high). A variable resistance of up to 150K ohms connected between one 
of these inputs and.the +5V supply controls the charging time of one of four 
().022-microfarad capacitors. When the voltage on the capacitor passes a 
certain threshold, the output of the NE558 changes back to 0 dow). 
Programs can determine the setting of a variable resistor by reset ting the 
timers and then counting time until the selected timer input changes from 
high to low. The resulting count is proportional to the resistance. 


Chapter 7: Hardware Implementation 


The game I/O signals are all available on a 16-pin DIP socket labelled 
GAME I/O on the main circuit board inside the case. The switches and the 
paddles are also available on a D-type miniature connector on the back of 


the Apple Ile; see J8 and J15 in Figure 7-138d. 


Table 7-19. Game I/O Connector Signals 


Internal- 
Connector 
Pin Number 


6,10,7,11 


8 
15,14,18,12 


9,16 


Back-Panel- 
Connector 
Pin Number 


2 


7,1,6 


0,8,4,9 
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Signal Name 


+5V 


PBO-PB2 


STROBE’ 


PDLO-PDL3 


GND 
ANO-ANB 


ILC. 


Description 


+5V power supply. Total current 
drain from this pin must not 
exceed 100mA. 


Switch inputs. These are 
standard 74LS inputs. 


Strobe output. This line goes low 
during #o of a read or write 
instruction to location $C040. 


Hand control inputs. Each of 
these should be connected to a 
150K-ohm variable resistor 
connected to +5V. 


System ground. 


Annunciators. These are 
standard 74LS TTL outputs and 
must be buffered to drive other 
than TTL inputs. 


Nothing is connected to these 
pins. 


heal 
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Chapter 6 describes the standards for 
programming peripheral cards for the 
Apple Ile. 
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The main circuit board of the Apple Ile has eight empty card con nectors or 
slots on it. These slots make it possible to add features to the Apple Ile by 
plugging in peripheral cards with additional hardware. This section 
describes the hardware that supports them, including all of the signals 
available on the expansion slots. 


The Expansion Slots 


SSS See 

The seven connectors lined up across the back part of the Apple Ile’s main 
circuit card are the expansion slots, also called peripheral slots or simply 
slots, numbered from 1 to 7. They are 50-pin PC-card edge connectors with 
pins on 0.10-inch centers. A PC card plugged into one of these comnectors 
has access to all of the signals necessary to perform input and output and to 
execute programs in RAM or ROM on the card. These signals are described 
briefly in Table 7-20. The following paragraphs describe the signals in 
general and mention afew points that are often overlooked. For further 
details, refer to the schematic diagram in Figures 7-18a, 7-18b, 7-18c, and 
7-18d. 


The Peripheral Address Bus 


The microprocessor’s address bus is buffered by two 74LS244 octal 
three-state buffers. These buffers, along with a buffer in the 
microprocessor’s R/W’ line, are enabled by a signal derived from. the DMA’ 
daisy-chain on the expansion slots. Pulling the peripheral line DMA’ low 
disables the address and R/W’ buffers so that peripheral DMA circuitry can 
control the address bus. The DMA address and R/W’ signals sup plied by a 
peripheral card must be stable all during ¢0 of the instruction cy cle, as 
shown in Figure 7-12. 


Another signal that can be used to disable normal operation of the Apple Ile 
is INH’. Pulling INH’ low disables all of the memory in the Apple Ile except 
the part in the 1/0 space from $C000 to $CFFF. A peripheral card that uses 
either INH’ or DMA’ must observe proper timing; in order to disable RAM 
and ROM cleanly, the disabling signal must be stable all during @0 of the 
instruction cycle (refer to the timing diagram in Figure 7-12). 


Chapter 7: Hardware Implementation 


The peripheral devices should use I/O SELECT’ and DEVICE SELECT’ as 
enables. Most peripheral [Cs require their enable signals to be present for a 
certain length of time before data is strobed into or out of the device. 
Remember that I/O SELECT’ and DEVICE SELECT’ are only asserted 
during $0 high. 


The Peripheral Data Bus 


The Apple Ile has two versions of the microprocessor data bus: an internal 
bus, MD0-MD7, connected directly to the microprocessor; and an external 
bus, D0-D7, driven by a 74LS245 octal bidirectional bus buffer. The 65C02 is 
fabricated with MOS circuitry, so it can drive capacitive loads of up to about 
130 pF. If peripheral cards are installed in all seven slots, the loading on the 
data bus can be as high as 500 pF, so the 74LS245 drives the data bus for the 
peripheral cards. The same argument applies if you use MOS devices on 
peripheral cards: they don’t have enough drive for the fully-loaded bus, so 
you should add buffers. 


Loading and Driving Rules 


Table 7-20 shows the drive requirements and loading limits for each pin on 
the expansion slots. The address bus, the data bus, and the R/W’ line 
should be driven by three-state buffers. Remember that there is 
considerable distributed capacitance on these busses and that you should 
plan on tolerating the added load of up to six additional peripheral cards. 
MOS devices such as PIAs and ACIAs cannot switch such heavy capacitive 
loads. Connecting such devices directly to the bus will lead to possible 
timing and level errors. 


Interrupt and DMA Daisy Chains 


The interrupt requests (IRQ’ and NMI’) and the direct-memory access 
(DMA’) signal are available at all seven expansion slots. A peripheral card 
requests an interrupt or a DMA transfer by pulling the appropriate output 
line low (active). If two peripheral cards request an interrupt ora DMA 
transfer at the same time, they will contend for the data and address 
busses. To prevent this, two pairs of pins on each connector are wired as a 
priority daisy chain. The daisy-chain pins for interrupts are INT IN and INT 
OUT, and the pins for DMA are DMA IN and DMA OUT, as shown for J1-J7 
in Figure 7-18d. 
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Each daisy chain works like this: the output from each connector goes to 
the input of the next higher numbered one. For these signals to be useful for 
cards in lower numbered connectors, all of the higher numbered connectors 
must have cards in them, and all of those cards must connect DMA IN to 
DMA OUT and INT IN to INT OUT. Whenever a peripheral card uses pin 
DMA’, it must do so only if its DMA IN line is active, and it must disable its 
DMA OUT line while it is using DMA’. The INT IN and INT OUT lines must 
be used the same way: enable the card’s interrupt circuits with INT IN, and 
disable INT OUT whenever IRQ’ or NMI’ is being used. 


Figure 7-12. Peripheral-Signal Timing 


- | | CPU Phase 


$1 | Video Phase | 


Address —> |-—140 ns (Max.) 30 ns aes! |— 
A0-A15, R/W’ 
INH’, DMA’ 


Peripheral Select 


1/0 SELECT’ 
DEVICE SELECT 


1/0 STROBE’ 
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Table 7-20. Expansion Slot Signals 


20 


21 


22 


23 
24 
25 


26 
27 


28 
29 


Name 


I/O SELECT 


A0-A15 


R/W’ 


SYNC’ 


1/0 STROBE’ 


RDY 


DMA’ 


INT OUT 
DMA OUT 
+5V 


GND 
DMA IN 


INT IN 


NMI’ 
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Description 


Normally high; goes low during @0 when the 65C02 
addresses location $CnXX, where n is the connector 
number. This line can drive 10 LS TTL loads.* 
Three-state address bus. The address becomes 
valid during @1 and remains valid during #0. Each 
address line can drive 5 LS TTL loads.* 
Three-state read/write line. Valid at the same time 
as the address bus; high during a read cycle, low 
during a write cycle. It can drive 2 LS TTL loads.” 
Composite horizontal and vertical sync, on 
expansion slot 7 only. This line can drive 2 LS TTL 
loads.* 

Normally high; goes low during ¢0 when the 65C02 
addresses a location between $C800 and $CFFF. 
This line can drive 4 LS TTL loads. 

Input to the 65C02. Pulling this line low during ¢1 
halts the 65C02 with the address bus holding the 
address of the location currently being fetched. 
This line has a 3300 ohm pullup resistor to +5V. 
Input to the address bus buffers. Pulling this line 
low during @1 disconnects the 65C02 from the 
address bus. This line has a 3300 ohm pullup 
resistor to +5V. 

Interrupt priority daisy-chain output. Usually 
connected to pin 28 (INT IN).t 

DMA priority daisy-chain output. Usually 
connected to pin 22 (DMA IN). 

+5-volt power supply. A total of 500mA is available 
for all peripheral cards. 

System common ground. 

DMA priority daisy-chain input. Usually connected 
to pin 24 (DMA OUT). 

Interrupt priority daisy-chain input. Usually 
connected to pin 23 (INT OUT). 

Non-maskable interrupt to 65C02. Pulling this line 
low starts an interrupt cycle with the 
interrupt-handling routine at location $08FB. This 
line has a 3300 ohm pullup resistor to +5V. 
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Table 7-20—Continued. Expansion Slot Signals 


Pin 
30 


3l 
32 


38 
34 
30 
36 
3” 
38 
39 


40 


4] 


42-49 


50 


Name 


IRQ’ 


RES’ 


INH’ 


-12V 

-5V 
3.08M 
7M 

Q3 

gl 
uPSYNC 
p0 
DEVICE 


SELECT’ 


DO0-D7 


+12V 


Description 


Interrupt request to 65C02. Pulling this line low 
starts an interrupt cycle only if the 
interrupt-disable (1) flag in the 65C02 is not set. 
Uses the interrupt-handling routine at location 
$03FE. This line has a 3300 ohm pullup resistor to 
+5V. 

Pulling this line low initiates a reset routine, as 
described in Chapter 4. 

Pulling this line low during @1 inhibits ( disables) 
the memory on the main circuit board. This line 
has a 3300 ohm pullup resistor to +5V. 

-12 volt power supply. A total of 200mA is available 
for all peripheral cards. 

-5 volt power supply. A total of 200mA is available 
for all peripheral cards. 

3.58 MHz color reference signal, on slot 7 only. This 
line can drive 2 LS TTL loads.* 

System 7 MHz clock. This line can drive 2 LS TTL 
loads.* 

System 2 MHz asymmetrical clock. This line can 
drive 2 LS TTL loads.* 

65C02 phase 1 clock. This line can drive 2 LS TTL 
loads.* 

The 65C02 signals an operand fetch by driving this 
line high during the first read cycle of each 
instruction. 

65C02 phase 0 clock. This line can drive 2 LS TTL 
loads.* 

Normally high; goes low during @0 when the 65C02 
addresses location $COnX, where n is the connector 
number plus 8. This line can drive 10 LS TTL 
loads.* 

Three-state buffered bi-directional data bus. Data 
becomes valid during ¢0 high and remains valid 
until @0 goes low. Each data line can drive one 

LS TTL load.* 

+12 volt power supply. A total of 250mA, is 
available for all peripheral cards. 


* Loading limits are for each card. 


t On slot 7 only, this pin can be connected to the graphics-mode signal GR: se e text for 


details. 
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Auxiliary Slot 


The large connector at the left side of the Apple IIe’s main circuit card is the 
auxiliary slot. It is a 60-pin PC-card edge connector with pins on 0.10-inch 
centers. A PC card plugged into this connector has access to all of the 
signals used in producing the video display. These signals are described 
briefly in Table 7-21. For further details, refer to the schematic diagram in 
Figures 7-13a, 7-13b, 7-18c, and 7-13d. 


Many of the internal signals that are not available on the expansion slots 
are on the auxiliary slot. By using both kinds of connectors, manufacturing 
and repair personnel can gain access to most of the signals needed for 
diagnosing problems in the Apple Ile. 


80-Column Display Signals 


The additional memory needed for producing an 80-column text display is 
on the 80-column text card, along with the buffers that transfer the data to 
the video data bus, as described earlier in this chapter in the section “Text 
Displays.” The signals that control the 80-column text data include the 
system clocks #0 and ¢1, the multiplexed RAM address RAO0-RA7, the RAM 
address-strobe signals PRAS’ and PCAS’, and the auxiliary-RAM enable 
signals, EN80’ and R/ W80. The EN80’ enable signal is controlled by the 
S8OSTORE soft switch described in Chapter 4. Data is sent to the auxiliary 
memory via the internal data bus MD0-MD7; the data is transferred to the 
video generator via the video data bus VIDO-VID7. 
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Table 7-21. Auxiliary Slot Signals 


Pin 


7 

8 
51,10,49,48, 
13,14,46,9 
11,12 
44,43,40,39, 
21,20,17,16 
45,42,41,38, 
22,19,18,15 
23 

24 

25 

26 

27 

28 


29 


Name 


3.08M 


VID7M 


SYNC’ 
PRAS’ 

VC 

COTX’ 
WNDW’ 
SEGA 
RAO-RA7 
ROMEN1, 
ROMEN2 
MDO-MD7 
VIDO-VID7 
p0 
CLRGAT’ 
80VID’ 
EN80’ 
ALTVID’ 
SEROUT’ 


ENVID’ 


Description 


3.58 MHz video color reference signal. This line can 
drive two LS TTL loads. 

Clocks the video dots out of the 74166 
parallel-to-serial shift register. This line can drive two 
LS TTL loads. 

Video horizontal and vertical sync signal. This line 
can drive two LS TTL loads. 

Multiplexed RAM row-address strobe. This line can 
drive two LS TTL loads. 

Third low-order vertical-counter bit. This line can 
drive two LS TTL loads. 

Hand-control reset signal. This line can drive two LS 
TTL loads. 

Video non-blank window. This line can drive two LS 
TTL loads. 

First low-order vertical counter bit. This line can 
drive two LS TTL loads. 

Multiplexed RAM-address bus. This line can drive 
two LS TTL loads. 

Enable signals for the ROMs on main circuit board. 


Internal (unbuffered) data bus. This line can drive 
two LS TTL loads. 

Video data bus. This three-state bus carries video 
data to the character generator. 

65C02 clock phase 0. This line can drive two LS TTL 
loads. 

Color-burst gating signal. This line can drive two LS 
TTL loads. 

Enables 80-column display timing. This line can drive 
two LS TTL loads. 

Enable for auxiliary RAM. This line can drive two LS 
TTL loads. 

Alternative video output to the video summing 
amplifier. 

Video serial output from 74166 parallel-to-serial shift 
register. 

Normally low; driving this line high disables the 
character generator such that the video dots from the 
shift register are all high (white), and alternative 
video can be sent out via ALTVID’. This lime has a 
1000 ohm pulldown resistor to ground. 
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Table 7-21—Continued. 
Pin Name 

30 +5 

31 GND 

32 14M 

33 PCAS’ 

34 LDPS’ 

35 R/W80 

36 gl 

37 CASEN’ 

47 HO 

50) AN3 

D2 R/W’ 

3 Q3 

4 SEGB 

ay) FRCTXT’ 
06,57 RAQ’,RA10° 
08 GR 

9 7M 

60 ENTMG’ 
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Auxiliary Slot Signals 


Description 


+5 volt power supply. 

System common ground. 

14.38 MHz master clock signal. This line can drive two 
LS TTL loads. 

Multiplexed column-address strobe. This line can 
drive two LS TTL loads. 

Strobe to video parallel-to-serial shift register. This 
signal goes low to load the contents of the video data 
bus into the shift register. This line can drive two LS 
TTL loads. 

Read/write signal for RAM on the card in this slot. 
This line can drive two LS TTL loads. 

65C02 clock phase 1. This line can drive two LS TTL 
loads. 

Column-address enable. This signal is disabled (held 
high) during accesses to memory on the card in this 
slot. This line can drive two LS TTL loads. 
Low-order horizontal byte counter. This line can drive 
two LS TTL loads. 

Output of annunciator number 3. This line can drive 
two LS TTL loads. 

65C02 read/write signal. This line can drive two LS 
TTL loads. 

2 MHz asymmetrical clock. This line can drive two LS 
TTL loads. 

Second low-order vertical-counter bit. This line can 
drive two LS TTL loads. 

Normally high; pulling this line low enables 14MHz 
video output even when GR is active. 
Character-generator control signals from the IOU. 
This line can drive two LS TTL loads. 
Graphics-mode enable signal. This line can drive two 
LS TTL loads. 

7 MHz timing signal. This line can drive two LS TTL 
loads. 

Normally low; pulling this line high disables the 
master timing from the PAL device. This line has a 
1000 ohm pulldown resistor to ground. 
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Appendix A The 65C02 Microprocessor 


This appendix contains a description of the differences between the 6502 
and the 65C02 microprocessors. It also contains the data sheet for the 65C02 
microprocessor. 


The 6502 microprocessor was used in the original Apple IIe, Apple II Plus, 
and Apple II. The 65C02 is a 6502 that uses less power and has ten new 
instructions and two new addressing modes. The 65C02 is used in both the 
enhanced Apple IIe and the Apple IIc. 


In the data sheet tables, execution times are specified in number of cycles. 
One cycle time for the Apple Ile equals 0.978 microseconds, giving a system 
clock rate of about 1.02 MHz. 


Note: If you want to write programs that execute on all computers in the 
Apple II series, use only those 65C02 instructions that are also present on 
the 6502. 


Differences Between 6502 and 65C02 
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The data sheet lists the instructions and addressing modes of the 65C02. 
This section supplements that information by listing those instructions 
whose execution times or results differ in the 6502 and the 65C02. 


Different Cycle Times 
Sa EE | 


A few instructions on the 65C02 operate in different numbers of c ycles than 
their 65C02 equivalents. These instructions are listed in Table A-1. 


Table A-1. Cycle Time Differences 


6502 65C02 
Instruction /Mode Opcode Cycles Cycles 
ASL Absolute, X 1E 7 6 
DEC Absolute, X DE 7 6 
INC Absolute, X FE fi 6 
JMP (Absolute) 6C 5 6 
LSR Absolute, X DE f 6 
ROL Absolute, X OE 7 6 
ROR Absolute, X (E 7 6 


Appendix A: The 65C02 Microprocessor 


Different Instruction Results 
ae ea ee ge ee) 


It is important to note that the BIT instruction when used in immediate 
mode (opcode $89) leaves processor status register bits 7 (N) and 6 (V) 
unchanged on the 65C02. On the 6502, all modes of the BIT instruction have 
the same effect on the status register: the value of memory bit 7 is placed in 
status bit 7, and memory bit 6 is placed in status bit 6. 


Also note that if the JMP indirect instruction (code $6C) references an 
indirect address location that spans a page boundary, the 65C02 fetches the 
high-order byte of the effective address from the first byte of the next page, 
while the 6502 fetches it from the first byte of the current page. For 
example, JMP ($02FF) gets ADL from location $02FF on both processors. 
But on the 65C02, ADH comes from $0300; on the 6502, ADH comes 

from $0200. 


Data Sheet 


The remaining pages of this appendix are copyright 1982, NCR Corporation, 
Dayton, Ohio, and are reprinted with their permission. 
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NCR65C02 


« GENERAL DESCRIPTION » PIN CONFIGURATION 


The NCR CMOS 6502 is an 8-bit microprocessor which is soft- 
ware compatible with the NMOS 6502. The NCR65CO02 hardware 
interfaces with all 6500 peripherals. The enhancements include 
ten additional instructions, expanded operational codes and 
two new addressing modes. This microprocessor has all of the ad- 
vantages of CMOS technology: low power consumption, increased 
noise immunity and higher reliability. The CMOS 6502 is a low 
power high performance microprocessor with applications in the 
consumer, business, automotive and communications market. 


s FEATURES 


@ Enhanced software performance including 27 additional OP codes 
encompassing ten new instructions and two additional 
addressing modes. 


® 66 microprocessor instructions. 


@ 15 addressing modes. 

@ 178 operational codes. 

© 1MHz, 2MHz operation. 

eee " NCR65SCO2 BLOCK DIAGRAM 
consumption (pseudo-static: stop during @2 high). 

@ Compatible with NMOS 6500 series | 


microprocessors. _--- - REGISTERSECTION CONTROL SECTION —- = 
© 64 K-byte addressable memory. 1 i 1 
e Interrupt capability. C. [ cay | 
LOGIC 

@ Lower power consumption. x 
4mA @ 1MHz. a 
@ +5 volt power supply. ac 
Aa 
@ §8-bit bidirectional data bus. -" 


© Bus Compatible with M6800. ae 
@ Non-maskable interrupt. 
ADORESS 


Bus 


@ 40 pin dual-in-line packaging. 


© §8-bit parallel processing ag Ore 
eae 
ras 


Qo (IN) 


PROCESSOA 
STATUS 
REGISTER P 


® Decimal and binary arithmetic. 


INTERNAL AOH 


@1 (OUT) 
@2 (OUT) 


INPUT DATA 
LATCH 


@ Pipeline architecture. 


RW 


@ Programmable stack pointer. 


DATA BUS 
BUFFER 


@ Variable length stack. 


INSTRUCTION 
REGISTER 


e Optional_internal pullups for 
(ROY, IRQ, SO, NMI and RES) 


LEGENO 


fi 08 BIT LINE 


81 6IT LINE 


Specifications are subject to 
change without notice. 


Copyright ©1982 by NCR Corporation, Dayton, Ohio, USA 
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NCR65C02 


® ABSOLUTE MAXIMUM RATINGS: 


RATING 
SUPPLY VOLTAGE 
INPUT VOLTAGE 
OPERATING TEMP. 
STORAGE TEMP. 


» PIN FUNCTION 


PIN 
AQ -Ai5 
DO - D7 


01, 02 


FUNCTION 
Address Bus 
Data Bus 
Interrupt Request 
Ready 
Memory Lock 
Non-Maskable Interrupt 
Synchronize 
Reset 
Set Overflow 
No Connection 
Read/Write 
Power Supply (+5V) 
Internal Logic Ground 
Clock Input 
Clock Output 


*This pin has an optional internal pullup for a No Connect condition. 


« DC CHARACTERISTICS 


Input High Voltage 
@o (IN) 
Input High Voltage 
RES, NMI, RDY, IRQ, Data, S.O. 
Input Low Voltage 
Oo (IN) 
RES, NMi, RDY, IRQ, Data, S.O. 
Input Leakage Current 
(Vin =0 to 5.25V, Wop = 5.25V) 
With pullups 
Without pullups 
Three State (Off State) | nput Current 
(Vin = 0.4 to 2.4V, Voc =5.25V) 
Data Lines 
Output High Voltage 
(lon =-100 féAde, Von =4.75V 
SYNC, Data, AO-A15, R/W) 
Out Low Voltage 
(lo = 1.6mAdc, Vp p = 4.75V 
SYNC, Data, AO-A15, R/W) 


Supply Current f = 1MHiz 
Supply Current f = 2MHiz 
Capacitance 
(Vin =0, Ta = 25°C, f = 1MHz) 

Logic 

Data 

A0-A15, R/W, SYNC 

Qo (IN) 


L | MIN. | TYP. | | MAX 
Vss + 2.4 =] Wop 
Vsg + 2.0 - 
| gar 
- Vsg + 0.8 


+30 
+1.0 


S 
= 


= 
c aA . = iz 
a re) 


S 


lpo 


Cin 


Cout 
COg (IN) 


Data Sheet 


(Vop = 5.0 V + 5%, Vsg =O V, Ta = 0’ to + 70°C) 


UNIT 
V 
V 
°C 
°C 


BA 
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NCR65C02 
® TIMING DIAGRAM 


tra tea, 


0 


01 


02 tel —--- —-— 
ADDR, FW i a Sc a 


t 
ce tl = OHR 
READ DATA ] , 
LLL | XU 
ris tonw 
wn reAT a 
oom > ae ee 
__ ee tecs 
50 > 
Note: All timing is referenced from a high voltage of 2.0 volts and a low voltage of 0.8 volts. 
»s NEW INSTRUCTION MNEMONICS 
HEX MNEMONIC DESCRIPTION 
80 BRA Branch relative always [Relative] 
3A DEA Decrement accumulator [Accum] 
1A INA Increment accumulator [Accum] 
DA PHX Push X on stack [Implied] 
5A PHY Push Y on stack [Implied] 
FA PLX Pull X from stack [Implied] 
7A PLY Pull Y from stack [Implied] 
9C STZ Store zero [Absolute] 
9E STZ Store zero [ABS, X] 
64 STZ Store zero (Zero page] 
74 STZ Store zero [ZPG,X] 
1C TRB Test and reset memory bits with accumulator [Absolute] 
14 TRB Test and reset memory bits with accumulator [Zero page] 
oc TSB Test and set memory bits with accumulator [Absolute] 
04 TSB Test and set memory bits with accumulator [Zero page} 
s ADDITIONAL INSTRUCTION ADDRESSING MODES 
HEX MNEMONIC DESCRIPTION 
72 ADC Add memory to accurnulator with carry [(ZPG) ] 
32 AND “AND” memory with accumulator [((ZPG)] 
3C BIT Test memory bits with accumulator [ABS, X] 
34 BIT Test memory bits with accumulator [ZPG, X] 
D2 CMP Compare memory and accumulator [(ZPG) ] 
52 EOR ‘Exclusive Or’’ memory with accumulator [(ZPG) ] 
7C JMP Jump (New addressing mode) (ABS(IND,X)] 
B2 LDA Load accumulator with memory [(ZPG)] 
12 ORA “OR” memory with accumulator [(ZPG)] 
F2 SBC Subtract memory from accumulator with borrow [(ZPG)] 
92 STA Store accumulator in memory [(ZPG) ] 
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NCR65C02 
s MICROPROCESSOR PROGRAMMING MODEL 


7 0 


[ad ACCUMULATOR A 


—_ | INDEX REGISTER Y 
— oa INDEX REGISTER X 


18 
PCH PCL 


7 
ft} stack poner s 


» FUNCTIONAL DESCRIPTION 


Timing Control 

The timing control unit keeps track of the instruction 
cycle being monitored. The unit is set to zero each time 
an instruction fetch is executed and is advanced at the 
beginning of each phase one clock pulse for as many 
cycles as is required to complete the instruction. Each 
data transfer which takes place between the registers de- 
pends upon decoding the contents of both the instruc- 
tion register and the tim ing control unit. 


Program Counter 

The 16-bit program counter provides the addresses which 
step the microprocessor through sequential instructions 
in a program. 

Each time the microprocessor fetches an instruction 
from program memory, the lower byte of the program 
counter (PCL) is placed on the low-order bits of the 
address bus and the higher byte of the program counter 
(PCH) is placed on the high-order 8 bits. The counter is 
incremented each time an instruction or data is fetched 
from program memory. 


Instruction Register and Decode 

Instructions fetched from memory are gated onto the 
internal data bus. These instructions are latched into the 
instruction register, thers decoded, along with timing and 
interrupt signals, to generate control signals for the var- 
ious registers. 


Arithmetic and Logic Umit (ALU) 

All arithmetic and logic operations take place in the 
ALU including incrementing and decrementing internal 
registers (except the program counter). The ALU has no 
internal memory and is used only to perform logical and 
transient numerical oper ations. 


Data Sheet 


PROGRAM COUNTER PC 


7 0 
NiIvililelolilzic| PROCESSOR STATUS 


REG ‘’P 


CARRY 1 = TRUE 
ZERO 1 = RESULT ZERO 


DECIMAL MODE 1 = TRUE 
BRK COMMAND 1 = BRK 
OVERFLOW 1 = TRUE 
NEGATIVE 1 = NEG. 


Accumulator 

The accumulator is a general purpose 8-bit register that 
stores the results of most arithmetic and logic operations, 
and in addition, the accumulator usually contains one of 
the two data words used in these operations. 


Index Registers 

There are two 8-bit index registers (X and Y), which 
may be used to count program steps or to provide an 
index value to be used in generating an effective address. 


When executing an instruction which specifies indexed 
addressing, the CPU fetches the op code and the base 
address, and modifies the address by adding the index 
register to it prior to performing the desired operation. 
Pre- or post-indexing of indirect addresses is possible (see 
addressing modes). 


Stack Pointer 

The stack pointer is an 8-bit register used to control the 
addressing of the variable-length stack on page one. The 
stack pointer is automatically incremented and decre- 
mented under control of the microprocessor to perform 
stack manipulations under direction of either the program 
or interrupts (NMI and IRQ). The stack allows simple 
implementation of nested subroutines and multiple level 
interrupts. The stack pointer should be initialized before 
any interrupts or stack operations occur. 


Processor Status Register 

The 8-bit processor status register contains seven status 
flags. Some of the flags are controlled by the program, 
others may be controlled both by the program and the 
CPU. The 6500 instruction set contains a number of 
conditional branch instructions which are designed to 
allow testing of these flags (see microprocessor program- 
ming model). 


TRG DISABLE 1 = DISABLE 
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NCR65C02 
e AC CHARACTERISTICS vVop = 5.0v + 5%, Ta = 0°C to 70°C, Load = 1 TTL + 130 pF 


pM MZ MHZ 
Parameter | Symbol | Min | Max |) Min | = Max |) Min | Max | Unit 
Delay Time, Op (Wto@ (OUT) [tory | - | 60 | - | 60 | 2 | 60 | vs 
Delay Time, 1 (OUT) 17 (OUT|_| torva | -20 | 20 | -20 | 20 | -2 | 2 | nS 
| tcye | 10 | 5000" | 0.50 | 5000" | 0.33 | 5000" | 


Cycle Time 


Clock Pulse Width Low rir | 460 | - | 220] - | to | - | 1s 

Clock Pulse Width High rtew | 460 | - | 20 | - | 160 | - | +s 

Fall Time, Rise Time fte.ta | - | 2% | - | % | - | |. 

Address Hold Time | 20 | 

Address Setup Time ltans | - 
|tacc | 


Access Time ta | 650 ns 
Read Data Hold Time ota. ae nS 
Read Data Setup Time ns 


| 20 | 

| 310 | = es 

a ee ee ee 

Rw a ee ae ee ee 

Write Data Delay Time ‘twos | - | 30 | - | 30 | - | 30 | 

Write Data Hold Time [toww | 20 | - | 20 | - [18 |= 
SO Setup Time itso | 100 | = | too | - | 100 | - | os 

Processor Control Setup Time"* | tecs_ | 200 | ~=- =| 150 | - | 150 | - | 

SYNC Setup Time ftsyvc | = | 225 | - | 140 | - | 100 | 

ML Setup Time ptm. | = | 228 | | 40 |= 100 

ee ee ee ee 


Input Clock Rise/Fall Time tego trgo 


*NCR65CO2 can be held static with @ 2 high. 
**This parameter must only be met to guarantee that the signal will be recognized at the current clock cycle. 


» MICROPROCESSOR OPERATIONAL ENHANCEMENTS 


| Punction = NMOS 6502 Microprocessor NCR65CO2 Microprocessor 
Indexed addressing across page boundary. | Extra read of invalid address. E xtra read of last instruction byte. 


Execution of invalid op codes. Some terminate only by reset. Results | All are NOPs (reserved for future use). 
are undefined. Op Code Bytes Cycles 
X2 2 2 
X3, X7, XB, XF 1 1 
44 2 3 
54, D4, F4 2 4 
5C 3 8 
DC, FC 3 4 


Jump indirect, operand = XXFF. Page address does not increment. Page address increments and adds one 
additional cycle. 

Read/modify/write instructions at One read and two write cycles. Two read and one write cycle. 

effective address. 

Decimal flag. Indeterminate after reset. Irvitialized to binary mode (D=0) after 
reset and interrupts. 


Flags after decimal operation. Invalid N, V and Z flags Valid flag adds one additional cycle 


Interrupt vector is loaded, BRK vector |BRK is executed, then interrupt is 
is ignored, executed. 


» MICROPROCESSOR HARDWARE ENHANCEMENTS 
| Function sss | CNMOSG502_ | CNCRGSCOD 


Assertion of Ready RDY during Ignored. Stops processor during @2. 
write operations. 


Unused input-only pins (TRO, NMI, Must be connected to low impedance | Connected internally by a high- 


RDY, RES, §0). signal to avoid noise problems. resistance to Vop (approximately 250 
K ohm.) 


Interrupt after fetch of BRK instruc- 
tion. 
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NCR65C02 
» ADDRESSING MODES 


Fifteen addressing modes are available to the user of the 
NCR65C0O2 microprocessor. The addressing modes are 
described in the following paragraphs: 


Implied Addressing [Implied] 

In the implied addressing mode, the address containing 
the operand is implicitly stated in the operation code of 
the instruction. 


Accumulator Addressing [Accum] 

This form of addressing is represented with a one byte 
instruction and implies an operation on the accumu- 
lator. 


Immediate Addressing [ Immediate] 

With immediate addressing, the operand is contained in 
the second byte of the instruction; no further memory 
addressing is required. 


Absolute Addressing [A bsolute] 

For absolute addressing, the second byte of the instruc- 
tion specifies the eight low-order bits of the effective 
address, while the third byte specifies the eight high-order 
bits. Therefore, this addressing mode allows access to the 
total 64K bytes of addressable memory. 


Zero Page Addressing [Zero Page] 

Zero page addressing allows shorter code and execution 
times by only fetching the second byte of the instruction 
and assuming a zero high address byte. The careful use 
of zero page addressing can result in significant increase 
in code efficiency. 


Absolute Indexed Addressing [ABS, X or ABS, Y] 
Absolute indexed addressing is used in conjunction with 
X or Y index register and is referred to as ‘‘Absolute, X,”’ 
and ‘‘Absolute, Y.’’ The effective address is formed by 
adding the contents of X or Y to the address contained 
in the second and third bytes of the instruction. This 
mode allows the index register to contain the index or 
count value and the instruction to contain the base 
address. This type of indexing allows any location refer- 
encing and the index to modify multiple fields, resulting 
in reduced coding and execution time. 


Zero Page Indexed Add ressing [ZPG, X or ZPG, Y] 

Zero page absolute adidressing is used in conjunction 
with the index register and is referred to as ‘‘Zero Page, 
X" or ‘‘Zero Page, Y.’’ The effective address is calculated 
by adding the second byte to the contents of the index 
register. Since this is a form of ‘‘Zero Page’’ addressing, 
the content of the second byte references a location in 
page zero. Additionally, due to the ‘’Zero Page’’ address- 
ing nature of this modle, no carry is added to the high- 
order eight bits of mermory, and crossing of page boun- 
daries does not occur. 


Relative Addressing [Relative] 
Relative addressing is used only with branch instructions; 


Data Sheet 


it establishes a destination for the conditional branch. 
The second byte of the instruction becomes the operand 
which is an “Offset’’ added to the contents of the pro- 


gram counter when the counter is set at the next in- 


struction. The range of the offset is —128 to +127 
bytes from the next instruction. 


Zero Page Indexed Indirect Addressing [((ND, X)] 

With zero page indexed indirect addres: ing (usually re- 
ferred to as indirect X) the second byte of the instruction 
is added to the contents of the X index register; the 
carry is discarded. The result of this addition points to a 
memory location on page zero whose contents is the low- 
order eight bits of the effective address. The next mem- 
ory location in page zero contains the high-order eight 
bits of the effective address. Both memory locations 
specifying the high- and low-order bytes of the effective 
address must be in page zero. 


*Absolute Indexed Indirect Addressing [ABS(IND, X)] 
(Jump Instruction Only) 

With absolute indexed indirect addressing the contents of 
the second and third instruction bytes are added to the 
X register. The result of this addition, points to a memory 
location containing the lower-order eight bits of the 
effective address. The next memory location contains 
the higher-order eight bits of the effective address. 


Indirect Indexed Addressing [(IND), Y] 

This form of addressing is usually referred to as Indirect, 
Y. The second byte of the instruction points to a mem- 
ory location in page zero. The contents of this memory 
location are added to the contents of the Y index regis- 
ter, the result being the low-order eight bits of the effec- 
tive address. The carry from this addition is added to the 
contents of the next page zero memory location, the 
result being the high-order eight bits of the effective 
address. 


*Zero Page Indirect Addressing [(ZPG)] 
In the zero page indirect addressing mode, the second 
byte of the instruction points to a memory location on 
page zero containing the low-order byte of the effective 
address. The next location on page zero contains the 
high-order byte of the effective address. 


Absolute Indirect Addressing [(ABS)] 

(Jump Instruction Only) 

The second byte of the instruction contains the low-order 
eight bits of a memory location. The high-order eight 
bits of that memory location is contained in the third 
byte of the instruction. The contents of the fully speci- 
fied memory location is the low-order byte of the effec- 
tive address. The next memory location contains the 
high-order byte of the effective address which is loaded 
into the 16 bit program counter. 


NOTE: * = New Address Modes 
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2® SIGNAL DESCRIPTION 


Address Bus (A0-A15) 
AO-A15 forms a 16-bit address bus for memory and |/O 
exchanges on the data bus. The output of each address 
line is TTL compatible, capable of driving one standard 
TTL load and 130pF. 


Clocks (09, 04, and 02) 

Qo is a TTL level input that is used to generate the inter- 
nal clocks in the 6502. Two full level output clocks are 
generated by the 6502. The @2 clock output is in phase 
with 09. The @1 output pin is 180° out of phase with Oo. 
(See timing diagram.) 


Data Bus (D0-D7) 

The data lines (DO-D7) constitute an 8-bit bidirectional 
data bus used for data exchanges to and from the device 
and peripherals. The outputs are three-state buffers 
capable of driving one TTL load and 130 pF. 


Interrupt Request (/RQ) 

This TTL compatible input requests that an interrupt 
sequence begin within the microprocessor. The IRQ is 
sampled during @9 operation; if the interrupt flag in the 
processor status register is zero, the current instruction 
is completed and the interrupt sequence begins during 
@4. The program counter and processor status register 
are stored in the stack. The microprocessor will then set 
the interrupt mask flag high so that no further !RQs 
may occur. At the end of this cycle, the program counter 
low will be loaded from address FFFE, and program 
counter high from location FFFF, transferring program 
control to the memory vector located at these addresses. 
The RDY signal must be in the high state for any inter- 
rupt to be recognized. A 3K ohm external resistor should 
be used for proper wire OR operation. 


Memory Lock (ML) = 

In a multiprocessor system, the ML output indicates the 
need to defer the rearbitration of the next bus cycle to 
ensure the integrity of read-modify-write instructions. 
ML goes low during ASL, DEC, INC, LSR, ROL, ROR, 
TRB, TSB memory referencing instructions. This signal 
is low for the modify and write cycles. 


Non-Maskable Interrupt (NMI) 

A negative-going edge on this input requests that a non- 
maskable interrupt sequence be generated within the 
microprocessor. The NMI is sampled during @2; the cur- 
rent instruction is completed and the interrupt sequence 
begins during @1. The program counter is loaded with 
the interrupt vector from locations FFFA (low byte) 
and FFFB (high byte), thereby transferring program con- 
trol to the non-maskable interrupt routine. 


Note: Since this interrupt is non-maskable, another NMI 
can occur before the first is finished. Care should be taken 
when using NMI to avoid this. 


NCR65C02 


Ready (RDY) 

This input allows the user to single-cycle the micropro- 
cessor on all cycles including write cycles. A negative 
transition to the low state, during or coincident with 
phase one (04), will halt the microprocessor with the out- 
put address lines reflecting the current address being 
fetched. This condition will remain through a subsequent 
phase two (@2) in which the ready signal is low. This fea- 
ture allows microprocessor interfacing with low-speed 
memory as well as direct memory access (DMA). 


Reset (RES) 

This input is used to reset the microprocessor. Reset 
must be held low for at least two clock cycles after 
VOD reaches operating voltage from a power down. A 
positive transistion on this pin will then cause an initiali- 
zation sequence to begin. Likewise, after the system has 
been eperating, a low on this line of at least two cycles 
will cease microprocessing activity, followed by initial- 
ization after the positive edge on RES. 


When a positive edge is detected, there is an initialization 
sequence lasting six clock cycles. Then the interrupt 
mask flag is set, the decimal mode is cleared, and the pro- 
gram counter is loaded with the restart vector from loca- 
tions FFFC (low byte) and FFFD (high byte). This is 
the start location for program control. This input should 
be high in normal operation. 


Read/Write (R/W) 

This signal is normally in the high state indicating that 
the microprocessor is reading data from memory or |/O 
bus. In the low state the data bus has valid data from the 
microprocessor to be stored at the addressed memory 
location. 


Set Overflow (SO) 

A negative transition on this line sets the overflow bit in 
the status code register. The signal is sampled on the trail- 
ing edge of 01. 


Synchronize (SYNC) 

This output line is provided to identify those cycles dur- 
ing which the microprocessor is doing an OP CODE 
fetch. The SYNC line goes high during 0; of am OP CODE 
fetch and stays high for the remainder of that cycle. If 
the RDY line is pulled low during the @1 clock pulse in 
which SYNC went high, the processor will stop in its 
current state and will remain in the state until the RDY 
line goes high. In this manner, the SYNC signal can be 
used to control RDY to cause single instruction execu- 
tion. 
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NCR65C02 
s INSTRUCTION SET — ALPHABETICAL SEQUENCE 


AOC 
AND 
ASL 
BCC 
BCS 
BEQ 
BIT 
BM! 
BNE 
BPL 
“BRA 
BRK 
BVC 
BVS 
CLC 
CLD 
CLI 
CLV 
CMP 
CPX 
CPY 
*DEA 
DEC 
DEX 
DEY 
EOR 
* INA 
INC 
INX 
INY 
JMP 
JSR 
LDA 


Note: 


Add Memory to Accumulator with Carry LDX 
“AND” Memory with Accumulator LDY 
Shift One Bit Left LSR 
Branch on Carry Clear NOP 
Branch on Carry Set ORA 
Branch on Result Zero PHA 
Test Memory Bits with Accumulator PHP 
Branch on Result Minus * PHX 
Branch on Result not Zero * PHY 
Branch on Result Plus PLA 
Branch Always PLP 

Force Break *PLX 
Branch on Overflow Clear *PLY 
Branch on Overflow Set ROL 
Clear Carry Flag ROR 
Clear Decimal Mode ATI 

Clear Interrupt Disable Bit ATS 
Clear Overflow Flag SBC 
Compare Memory and Accumulator SEC 
Compare Memory and Index X SED 
Compare Memory and Index Y SEI 

Decrement Accumulator STA, 
Decrement by One STX 
Decrement | ndex X by One STY 
Decrement | ndex Y by One *STZ 
“Exclusive-or’’ Memory with Accumulator TAX 
Increment Accumulator TAY 
Increment by One *TRB 
Increment Index X by One *TSB 
Increment Imdex Y by One TSX 
Jump to New Location TXA 
Jump to New Location Saving Return Address TXS 
Load Accumulator with Memory TYA 


# 


= New Instruction 


» MICROPROCESSOR OP CODE TABLE 


7 
ORA TSB* ORA ASL 
ind, X zpg zpg zpg 
BPL ORA |ORA‘T TRB*| ORA ASL 
rel ind, Y (zpg) zpg zpg, X | zpg, X 
JSR 
abs 
AND |AND*Tt BIT* | AND ROL SE 
ind, Y (zpg) zpg, X ae zpg, Xx abs, Y 
LSR 
peek zpg 
BVC EOR |EOR*T EOR LSR 
rel ind, Y | (zpg) oe zpg, X 
RATS ADC ae ar 
ind, X zpg 
BVS ADC |ADC*‘tT er ADC aon ADC PLY® 
rel ind, Y (z2pg) zpg, X | zpg, X | zpg, X abs, Y 
BRA®* STA ae DEY BIT? TXA STY STA STX 
rel ind, X pe imm abs abs abs 
BCC STA |STA°T a a TYA STA TXS STZ° STZ* 
rel ind, Y (zpg) zpg, X | zpg, ue? zpg, Y abs, Y abs ae . abs, X 
LDY | LDA LDXx LDY LDA LOX TAY LDA | TAX LDY LDA LDX 
imm ind, X iram zpg zpg zpg imm abs abs abs 
LDA LDA‘T LOY LDA LDX CLV LOA | TSX LDY LDA LOX 
ind, Y (zpg) zpg, X | zpg, X | zpg, Y abs, Y abs, X abs, X abs, Y 
CPY CMP CPY CMP DEC INY CMP CPY 
imm ind, x zpq zpg zpg imm abs 
CMP crept CMP DEC CLO CMP CMP 
ind, Y (zpg) zpg, X | zpg, X abs, Y abs, X 
an SBC INC SBC sBc 
rn zpg imm abs 


pee dae | TL ats fan] | 
abs, Y abs, X 
pot 1 {2tste}s {oe f{7ts fo {afte} ¢c |ofe {er} | 


sec sect INC 
ind, Y ( zpg) Ee zpg, X 


BIT AND ROL 
zpg zpg zpg 


= = New OP Codes 
Note: t = New Address Modes 


Data Sheet 


CL OR 
Oa Y 
AOC 


PL 
imm 


Load Index X with Memory 

Load Index Y with Memory 

Shift One Bit Right 

No Operation 

“OR” Memory with Accumulator 
Push Accumulator on Stack 

Push Processor Status on Stack 
Push Index X on Stack 

Push Index Y on Stack 

Pull Accumulator from Stack 

Pull Processor Status from Stack 
Pull index X from Stack 

Pull Index Y from Stack 

Rotate One Bit Left 

Rotate One Bit Right 

Return from Interrupt 

Return from Subroutine 

Subtract Memory from Accumulator with Borrow 
Set Carry Flag 

Set Decimal Mode 

Set Interrupt Disable Bit 

Store Accumulator in Memory 
Store index X in Memory 

Store Index Y in Memory 

Store Zero in Memory 

Transfer Accumulator to Index X 
Transfer Accumulator to Index Y 
Test and Reset Memory Bits with Accumulator 
Test and Set Memory Bits with Accumulator 
Transfer Stack Pointer to Index X 
Transfer Index X to Accumulator 
Transfer Index X to Stack Pointer 
Transfer Index Y to Accumulator 


TSB* ORA 
abs abs ne 
TRB* ORA ASL 
abs abs, X abs, X 


JMP EOR 
abs abs 


BIT*Tt AND ROL 
abs, X abs, X abs, X 
EOR LSA 
abs, X | abs, X 


BIT AND ROL 
abs abs abs 


JMP ADC ROR 

(abs) abs abs 

JMP*t ADC ROR 7 
abs (ind, X)| abs, X abs, X 
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NCR65C02 
» OPERATIONAL CODES, EXECUTION TIME, AND MEMORY 


REQUIREMENTS 


IMME-| ABSO- | ZERO IM- oe RELA- PROCESSOR 
mat mul PAGE PLIED 2PG, Y ABS, Y} TIVE es 


71 . 
2 31 
90 
80 
89 

30 
Branch if Z=0 00 
Branch if N=0 10 
Branch Always 80 
Break 00|7 
Branch if V=0 50 
Branch if V=1 70 
o°c 18/2 : 


haa OPERATION 


ADC|A+M+CrA = 
ANDI|IAAM?*A 


Branch if C=0 
Branch if C=1 


Branch if Z2=1 (2) 
AAM (4,5) 
Branch if N=1 (2) 


n 
°o 


Jump to new loc 
Jump Subroutine 

MeA (1) 
Mex 


S+1*S MP 
S+1*S Mex 


$+1*°S Mey 


oF —a-te (1) 
Cee 4 (1) 
Return from Inter. 

Return from Subr. 
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pape CT TO 


Notes: 
1. Add 1 to ‘’n”’ if page boundary is crossed. X Index X + Add n No. Cycles 
2. Add 1 to ‘‘n’’ if branch occurs to same page. Y Index Y — Subtract # No. Bytes 
Add 2 to ‘‘n”’ if branch occurs to different page. A Accumulator A And Mg Memory bit 6 
3. Add 1 to ’’n” if decimal mode. M Memory per effective address V Or M7 Memory bit 7 
4. V bit equals memory bit 6 prior to execution. Ms Memory per stack pointer MV Exclusive or 


N bit equals memory bit 7 prior to execution. 
*5, The immediate addressing mode of the BIT instruction leaves bits 6 & 7 
(V & N)in the Processor Status Code Register unchanged. 
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Appendix B Directory of Built-in Subroutines 
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AWarning 


Here is a list of useful subroutines in the Apple IIe’s Monitor. To use these 
subroutines from machine-language programs, store data into the specified 
memory locations or microprocessor registers as required by the subroutine 
and execute a JSR to the subroutine’s starting address. After the subroutine 
performs its function, it returns with the 65C02’s registers changed as 
described. 


For the sake of compatibility between the Apple II Plus, Apple IIc, and 
the Apple Ile, do not jump into the middle of Monitor subroutines. The 
starting addresses are the same for all models of the Apple II, but the 
actual code is different. 


BASICIN _ Read the keyboard $0305 


When the 80-column firmware is active, BASICIN is used instead of KEYIN. 
BASICIN operates like KEYIN except that it displays a solid, non- blinking 
cursor instead of a blinking checkerboard cursor. 


BASICOUT Output to screen $C307 


When the 80-column firmware is active, BASICOUT is used instead of 
COUT1. BASICOUT displays the character in the accumulator on the 
Apple Ile’s screen at the current output cursor position and advances the 
output cursor. It places the character using the setting of the 
Normal/Inverse location. It handles control codes; see Table 3-3b-. 
BASICOUT returns with all registers intact. 


BELL Output a bell character SFF3A 


BELL writes a bell (Control-G) character to the current output device. It 
leaves the accumulator holding $87. 


BELLI Sends a beep to the speaker $FBDD 


BELL] generates a 1 kHz tone in the Apple Ile’s speaker for 0.1 second. It 
scrambles the A and X registers. 


CLREOL _ Clear toend of line $FC9C 


CLREOL clears a text line from the cursor position to the right edge of the 
window. CLREOL destroys the contents of A and Y. 
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CLEOLZ Clear toend of line $FC9E 
CLEOLZ clears a text line to the right edge of the window, starting at the 
location given by base address BASL, which is indexed by the contents of 
the Y register. CLEOLZ destroys the contents of A and Y. 

CLREOP Clear to end of window $FC42 
CLREOP clears the text window from the cursor position to the bottom of 
the window. CLREOP destroys the contents of A and Y. 

CLRSCR Clear the low-resolution screen $F832 


CLRSCR clears the low-resolution graphics display to black. If you call 
CLRSCR while the video display is in text mode, it fills the screen with 
inverse-mode at-sign (@) characters. CLRSCR destroys the contents of A 
and Y. 


CLRTOP Clear the low-resolution screen $F836 
CLRTOP is the same as CLRSCR (above), except that it clears only the top 
40 rows of the low-resolution display. 

COUT Output a character $FDED 


COUT calls the current character output subroutine. The character to be 
output should be in the accumulator. COUT calls the subroutine whose 
address is stored in CSW (locations $36 and $37), which is usually one of 
the standard character output subroutines, COUT1 or BASICOUT. 


COUT1 Output to screen $FDF0 


COUT! displays the character in the accumulator on the Apple Ile’s screen 
at the current output cursor position and advances the output cursor. It 
places the character using the setting of the Normal/Inverse location. It 
handles the codes for carriage return, linefeed, backspace, and bell. It 
returns with all registers intact. 

CROUT Generate a carriage return character $FD8E 


CROUT sends a carriage return character to the current output device. 


CROUTI1 — Generate carriage return, clear rest of line $FD8B 


CROUT! clears the screen from the current cursor position to the edge of 
the text window, then calls CROUT. 
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GETLN Get an input line with prompt $FD6A 


GETLN is the standard input subroutine for entire lines of characters, as 
described in Chapter 3. Your program calls GETLN with the prompt 
character in location $33; GETLN returns with the input line in the input 
buffer (beginning at location $0200) and the X register holding the length of 
the input line. 


GETLNZ Get aninput line $FD67 
GETLNZ is an alternate entry point for GETLN that sends a carriage return 
to the standard output, then continues into GETLN. 

GETLN1 Get an input line, no prompt SFD6F 


GETLN1 is an alternate entry point for GETLN that does not issue a prompt 
before it accepts the input line. If, however, the user cancels the input line, 
either with too many backspaces or with a [CONTROL }{x], then GETLN1 
will issue the contents of location $33 as a prompt when it gets another line. 


HLINE Draw a horizontal line of blocks $F819 


HLINE draws a horizontal line of blocks of the color set by SETCOL on the 
low-resolution graphics display. Call HLINE with the vertical coordinate of 
the line in the accumulator, the leftmost horizontal coordinate in the 

Y register, and the rightmost horizontal coordinate in location $2C. HLINE 
returns with A and Y scrambled, X intact. 


HOME Home cursor and clear $FC58 
HOME clears the display and puts the cursor in the home position: the 
upper-left corner of the screen. 

IOREST Restore all registers $FFSF 
IOREST loads the 65C02’s internal registers with the contents of memory 
locations $45 through $49. 

IOSAVE _ Saveall registers SFF4A 


IOSAVE stores the contents of the 65C02’s internal registers in locations $45 
through $49 in the order A, X, Y, P, S. The contents of A and X are changed 
and the decimal mode is cleared. 
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KEYIN Read the keyboard $FDIB 


KEYIN is the keyboard input subroutine. It reads the Apple Ile’s keyboard, 
waits for a keypress, and randomizes the random number seed at $4E-$4F. 
When a key is pressed, KEYIN removes the blinking cursor from the display 
and returns with the keycode in the accumulator. KEYIN is described in 
Chapter 3. 


MOVE Move a block of memory $FE2C 


MOVE copies the contents of memory from one range of locations to 
another. This subroutine is the same as the MOVE command in the Monitor, 
except that it takes its arguments from pairs of locations in memory, 
low-byte first. The destination address must be in A4 ($42-$48), the starting 
source address in Al ($3C-$3D), and the ending source address in A2 
($3E-$3F) when your program calls MOVE. Register Y must contain $00 
when your program calls MOVE. 


NEXTCOL Increment color by 3 $F85F 
NEXTCOL adds 8 to the current color (set by SETCOL) used for 
low-resolution graphics. 

PLOT Plot on the low-resolution screen $F'800 


PLOT puts a single block of the color value set by SETCOL on the 
low-resolution display screen. The block’s vertical position is passed in the 
accumulator, its horizontal position in the Y register. PLOT returns with the 
accumulator scrambled, but X and Y intact. 

PRBLNK Print three spaces $F948 
PRBLNK outputs three blank spaces to the standard output device. On 
return, the accumulator usually contains $A0, the X register contains 0. 
PRBL2 Print many blank spaces $F9O4A 


PRBL2 outputs from 1 to 256 blanks to the standard output device. Upon 
entry, the X register should contain the number of blanks to be output. If 
X=$00, then PRBL2 will output 256 blanks. 


PRBYTE Print a hexadecimal byte $FDDA 


PRBYTE outputs the contents of the accumulator in hexadecimal on the 
current output device. The contents of the accumulator are scrambled. 
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PREAD Read a hand control SFBIE 


PREAD returns a number that represents the position of a hand control. You 
pass the number of the hand control in the X register. If this num ber is not 
valid (not equal to 0, 1, 2, or 3), strange things may happen. PREAD returns 
with a number from $00 to $FF in the Y register. The accumulator is 
scrambled. 


PRERR Print ERR $FF2D 
PRERR sends the word ERR, followed by a bell character, to the standard 
output device. On return, the accumulator is scrambled. 

PRHEX Print a hexadecimal digit $FDE3 
PRHEX prints the lower nibble of the accumulator as a single hexadecimal 
digit. On return, the contents of the accumulator are scrambled. 
PRNTAX Print Aand X in hexadecimal $F941 


PRNTAX prints the contents of the A and X registers as a four-digit 
hexadecimal value. The accumulator contains the first byte output, the X 
register contains the second. On return, the contents of the accumulator are 
scrambled. 


RDCHAR _ Get aninput character or escape code $FD35 


RDCHAR is an alternate input subroutine that gets characters from the 
standard input subroutine, and also interprets the escape codes listed in 
Chapter 3. 


RDKEY Get an input character $FDOC 


RDKEY is the character input subroutine. It places a blinking cursor on the 
display at the cursor position and jumps to the subroutine whose address is 
stored in KSW (locations $38 and $39), usually the standard input 
subroutine KEYIN, which returns with a character in the accumu lator. 


READ Read a record from a cassette SFEFD 


READ reads a series of tones at the cassette input port, converts t hem to 
data bytes, and stores the data in a specified range of memory locations. 
Before calling READ, the address of the first byte must be in Al ($3C-$3D) 
and the address of the last byte must be in A2 ($3E-$8F). 
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READ keeps a running exclusive-OR of the data bytes in CHKSUM ($2). 
When the last memory location has been filled, READ reads one more byte 
and compares it with CHKSUM. If they are equal, READ sends out a beep 
and returns; if not, it sends the string ERR through COUT, sends the beep, 
and returns. 


SCRN Read the low-resolution graphics screen $F871 


SCRN returns the color value of a single block on the low-resolution 
graphics display. Call it with the vertical position of the block in the 
accumulator and the horizontal position in the Y register. Call it as you 
would call PLOT (above). The color of the block will be returned in the 
accumulator. No other registers are changed. 


SETCOL Set low-resolution graphics color $F864 


SETCOL sets the color used for plotting in low-resolution graphics to the 
value passed in the accumulator. The colors and their values are listed in 
Table 2-6. 


SETINV Set inverse mode SFE80 


SETINV sets the dislay format to inverse. COUT] will then display all 
output characters as black dots on a white background. The Y register is set 
to $8F, all others are unchanged. 


SETNORM Set normal mode $PE84 


SETNORM sets the display format to normal. COUT] will then display all 
output characters as white dots on a black background. On return, the 
Y register is set to $FF, all others are unchanged. 


VERIFY = Compare two blocks of memory $FE36 


VERIFY compares the contents of one range of memory to another. This 
subroutine is the same as the VERIFY command in the Monitor, except it 
takes its arguments from pairs of locations in memory, low-byte first. The 
destination address must be in A4 ($42-$43), the starting source address in 
Al ($8C-$3D), and the ending source address in A2 ($3E-$3F) when your 
program calls VERIFY. 
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VLINE Draw a vertical line of blocks $F828 


VLINE draws a vertical line of blocks of the color set by SETCOL on the 
low-resolution display. You should call VLINE with the horizontal 
coordinate of the line in the Y register, the top vertical coordinate in the 
accumulator, and the bottom vertical coordinate in location $2D. VLINE will 
return with the accumulator scrambled. 


WAIT Delay $FCA8 


WAIT delays for a specific amount of time, then returns to the program that 
called it. The amount of delay is specified by the contents of the 
accumulator. The delay is 1/2(26+27A+5A * 2) microseconds, where A is 
the contents of the accurmulator. WAIT returns with the accumulator 
zeroed and the X and Y registers undisturbed. 


WRITE Write a record on a cassette $FECD 


WRITE converts the data in a range of memory to a series of tones at the 
cassette output port. Before calling WRITE, the address of the first data 
byte must be in Al ($3C-$3D) and the address of the last byte must be in A2 
($3E-$3F). The subroutine writes a ten-second continuous tone as a header, 
then writes the data followed by a one-byte checksum. 
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This appendix lists the differences among the Apple II Plus, the original and 
the enhanced Apple Ile, and the Apple IIc. 


If you're trying to write software to run on more than one version of the 
Apple II, this appendix will help you avoid unexpected problems of 
incompatibility. 


The differences are listed here in approximately the order you are likely to 
encounter them: obvious differences first, technical details later. Each entry 
in the list includes references to the chapters in this manual where the item 
is described. 


Keyboard 


The Apple Ile and Apple IIc have a full 62-key uppercase and lowercase 
keyboard. The keyboard includes fully-operational and 

keys. It also includes four directional arrow keys for moving 
the cursor. Chapter 2 includes a description of the keyboard. The 
cursor-motion keys are described in Chapter 3. 


Apple Keys 


The keyboard of the Apple Ile and Apple IIc have two keys marked with the 
Apple logo. These keys, called the Open-Apple key ((G]) and Solid-Apple 
key ({@]), are used with the key to select special reset functions. 
They are connected to the buttons on the hand controls, so they can be used 
for special functions in programs. 


The Apple II and the Apple II Plus do not have Apple keys. 


Character Sets 
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The Apple Ile and Apple IIc can display the full ASCII character set, 
uppercase and lowercase. For compatibility with older Apple II’s, the 
standard display character set includes flashing uppercase instead of 
inverse-format lowercase; you can also switch to an alternate character set 
with inverse lowercase and uppercase, but no flashing. Chapter 2 includes a 
description of the display character sets. Chapter 3 tells you how to switch 
display formats. 
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The Apple IIc and the enhanced Apple Ile include a set of “graphic” text 
characters, called MouseText characters, that replace some of the inverse 
uppercase characters in the alternate character set of the original Apple Ile. 
MouseText characters are described in Chapter 2. 


80-Column Display 

TT A aa aa ee ee a a 
With the addition of an 80-column text card, the Apple IIe can display 80 
columns of text. The 80-column display is completely compatible with both 
graphics modes—you can even use it in mixed mode. (If you prefer, you can 
use an old-style 80-column card in an expansion slot instead.) Chapter 2 
includes a description of the 80-column display. 


The Apple IIc has a built-in extended 80-column card. 


Escape Codes and Control Characters 

a 
On the Apple Ile and Apple IIc, the display features mentioned above (and 
many others not mentioned) can be controlled from the keyboard by escape 
sequences and from programs by control characters. Chapter 3 includes 
descriptions of those escape codes and control characters. 


Built-in Language Card 

CEE eee 
The 16K bytes of RAM you add to the Apple II Plus by installing the 
Language Card is built into the Apple Ile and Apple IIc, giving the Apple Ile 
a standard memory size of 64K bytes. (The Apple IIc has a built-in extended 
80-column text card as well, giving it a standard memory size of 128K 
bytes.) In the Apple Ile, this 16K-byte block of memory is called the 
bank-switched memory. It is described in Chapter 4. 
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Auxiliary Memory 


By installing the Apple Ile Extended 80-Column Text Card, you can add an 
alternate 64K bytes of RAM to the Apple Ile. Chapter 4 tells you how to use 
the additional memory. (The Extended 80-Column Text Card also provides 
the 80-column display option. ) 


The Apple IIc has a built-in extended 80-column text card. 


Auxiliary Slot 


In addition to the expansion slots on the Apple II Plus, the Apple [le has a 
special slot that is used either for the 80-Column Text Card or for the 
Extended 80-Column Text Card. This slot is identified in Chapter 1 and 


- described in Chapter 7. 


The Apple IIc has the functions of the auxiliary slot built in. 


Back Panel and Connectors 


The Apple Ile has a metal back panel with space for several D-type 
connectors. Each peripheral card you add comes with a connector that you 
install in the back panel. Chapter | includes a description of the back panel; 
for details, see the installation instructions supplied with the peripheral 
cards. 


The Apple IIc back panel has seven built-in connectors. 


Soft Switches 


Sa ae ee 
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The display and memory features of the Apple Ile and the Apple [Ic are 
controlled by soft switches like the ones on the Apple II Plus. On the 

Apple Ile and the Apple IIc, programs can also read the settings of the soft 
switches. Chapter 2 describes the soft switches that control the display 
features, and Chapter 4 describes the soft switches that control the memory 
features. 
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Built-in Self-Test 

a See Oe eS, Ee Se ee | 
The Apple Ile has built-in firmware that includes a self-test routine. The 
self-test is intended primarily for testing during manufacturing, but you can 
run it to be sure the Apple Ile is working correctly. The self-test is described 
in Chapter 4. 


The Apple llc also has built-in diagnostics. 


Forced Reset 

TO es 
Some programs qn the Apple II Plus take control of the reset function to 
keep users from stopping the machine and copying the program. The 
Apple Ile and Apple IIc have a forced reset that writes over the program in 
memory. By using the forced reset, you can restart the Apple Ile (or 
Apple IIc) without turning power off and on and causing unnecessary stress 
on the circuits. The forced reset is described in Chapter 4. 


Interrupt Handling 

a NN ee a ees 
Even though most application programs don’t use interrupts, the Apple Ile 
(and Apple IIc) provide for interrupt-driven programs. For example, the 
80-column firmware periodically enables interrupts while it is clearing the 
display (normally a long time to have interrupts locked out). Interrupts are 
discussed in Chapter 6. 


Vertical Sync for Animators 
Oe er ee 
Programs with animation on the Apple Ile and Apple IIc can stay in step 
with the display and avoid flickering objects in their displays. Chapter 7 
includes a description of the video generation and the vertical sync. 
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Signature Byte 
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A program can find out whether it’s running on an Apple Ile, Apple IIc, 
Apple III (in emulation mode), or on an older model Apple II by reading the 
byte at location $FBB3 in the System Monitor. In the Apple IIe Monitor, this 
byte’s value is $06; in the Autostart Monitor (the standard Monitor on the 
Apple II Plus), its value is $EA. (Note: if you start up with DOS and switch 
to Integer BASIC, the Autostart Monitor is active and the value at location 
$FBB8 is $EA, even on an Apple Ile.) Obviously, there are lots of other 
locations that have different values in the different versions of the Monitor, 
location $FBB3 was chosen because it will have the value $06 even in 
future revisions of the Apple IIe Monitor. 


Hardware Implementation 


CEE TE eee 


All of these features are described in 
Chapter 7. 


For more information about the Apple IIc, 
see the Apple IIc Reference Manual. 
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The hardware implementation of the Apple Ile is radically different from 
the Apple II and Apple II Plus. Three of the more important differences are 
oO the custom ICs: the IOU and MMU 

o the video hardware, which uses ROM to generate both text and graphics 
Oo the peripheral data bus, which is fully buffered. 


The Apple IIc 


O shares some of the custom ICs of the Apple Ile 
O has some new ones all its own 


O lacks the slots of the Apple Ile, replacing some of them with built-in 1/0 
ports. 
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This appendix is an overview of the characteristics of operating systems 
and languages when run on the Apple Ile. It is not intended to be a full 
account. For more information, refer to the manuals that are provided with 
each product. 


Operating Systems 


EE SSS Se! 
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This section discusses the operating systems that can be used with the 
Apple Ile. 


ProDOS 


eres 

ProDOS is the preferred disk operating system for the Apple IIe. It supports 
interrupts, startup from drives other than a Disk II, and all other hardware 
and firmware features of the Apple Ile. 


DOS 3.3 


era eae ae 

The Apple Ile works with DOS 8.3. The Apple Ile can also access DOS 3.2 
disks by using the BAS/C'S disk. However, neither version of DOS takes full 
advantage of the features of the Apple IIe. DOS support is provided only for 
the sake of Apple II series compatibility. 


Pascal Operating System 
SS a ee ee ee 


The Apple II Pascal operating system was developed from the UCSD Pascal 
system from the University of California at San Diego. While it shares many 
characteristics of that system, it has been extended by Apple in several 
areas. 


Pascal versions 1.2 and later support interrupts and all the hardware and 
firmware features of the Apple Ile. 


The Apple II Pascal system uses a disk format different than either ProDOS 
or DOS 3.3. 
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CP/M 

ae) 

CP/M® is an operating system developed by Digital Research that runs on 
either the Intel 8080 or Zilog Z80® microprocessors. This means that a 
co-processor peripheral card, available from several manufacturers for the 
Apple Ile, is required to run CP/M. Several versions of CP/M from 1.4 
through 3.0 and later can be run on an Apple [le with an appropriate 
co-processor card. 


Languages 
T_T RSS a A a fC Sy OTTOMAN ek) RRL Se 

This section discusses special techniques to use, and characteristics to be 

aware of, when using Apple programming languages with the Apple Ile. 


Assembly Language 
SSS See 


An aid for assembly-Language programming Programs written in assembly language have the potential of extracting the 
is ProDOS Assembler Tools (A2W0018). most speed and efficiency from your Apple Ile, but they also require the 
most effort on your part. 


Appiesoft BASIC 
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The focus of the chapters in this manual is assembly language, and so most 
addresses and values are given in hexadecimal notation. Appendix E in this 
manual includes tables to help you convert from hexidecimal to the decimal 
notation you will need for BASIC. 


In BASIC, use a PEEK to read a location (instead of the LDA used in 
assembly language), and a POKE (instead of STA) to write to a location. If 
you read a hardware address from a BASIC program, you get a value 
between 0 and 255. Bit 7 holds a place value of 128, so if a soft switch is on, 
its value will be equal to or greater than 128: if the switch is off, the value 
will be less than 128. 


Integer BASIC 


(re 

Integer BASIC is not included in the Apple Ile firmware. If you want to run 
it on your Apple Ile, you must use DOS 3.3 to load it in to the system. 
ProDOS does not support Integer BASIC. 
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Pascal Language 
Se ee) 


The Pascal language works on the Apple Ile under versions 1.1 and later of 
the Pascal Operating System. However, for best performance, use Pascal 1.2 
or a later version. 


FORTRAN 


ee ete eens 

FORTRAN works under version 1.1 of the Pascal Operating System which 
does not detect or use certain Apple Ile features, such as auxiliary memory. 
Therefore, FORTRAN does not take advantage of these features. 
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This appendix briefly discusses bits and bytes and what they can represent. 
It also contains conversion tables for hexadecimal to decimal and negative 
decimal, for low-resolution display dot patterns, display color values, and a 
number of 8-bit codes. 


These tables are intended for convenient reference. This appendix is not 
intended as a tutorial for the materials discussed. The brief section 
introductions are for orientation only. 


Bits and Bytes 


Te en ey ee a) 


This section discusses the relationships between bit values and their 
position within a byte. The following are some rules of thumb regarding the 
65C02 and 6502. 


oO A bit is a binary digit; it can be either a 0 or a 1. 


oO A bit can be used to represent any two-way choice. Some choices that a 
bit can represent in the Apple Ile are listed in Table E-1. 


Table E-1. What a Bit Can Represent 


Context Representing 0= = 
Binary number Place value 0 1 x that power of 2 
Logic Condition False True 
Any switch Position Off On 
Any switch Position Clear* Set 
Serial transfer Beginning Start Carrier (no informa tion yet) 
Serial transfer Data Qvalue  1value 
Serial transfer Parity SPACE MARK 
Serial transfer End Stop bit(s) 
Serial transfer Communication BREAK Carrier 
state 
P reg. bit N Neg. result? No Yes 
P reg. bit V Overflow? No Yes 
P reg. bit B BRK command? No Yes 
P reg. bit D Decimal mode? No Yes 
P reg. bit I IRQ interrupts Enabled Disabled (masked out) 
P reg. bit Z Zero result? No Yes 
P reg. bit C Carry required? No Yes 


* Sometimes ambiguously termed reset. 
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O Bits can also be combined in groups of any size to represent numbers. 
Most of the commonly used sizes are multiples of four bits. 


o Four bits comprise a nibble (sometimes spelled nybble). 


O One nibble can represent any of 16 values. Each of these values is 
assigned a number from 0 through 9 and (because our decimal system 
has only ten of the sixteen digits we need) A through F. 


Oo Eight bits (two nibbles) make a byte (Figure E-1). 


Figure E-1. Bits, Nibbles, and Bytes 


High Nibble Low Nibble 
———— ee, 
MSB LSB 
(| 6 D 4 3 2 l 0 


$80 $40 $20 $10 $08 $04 $02 $01 Hexadecimal 
128 64 32 16 8 4 2 l Decimal 


Binary Hex Dec 
0000 $00 0 
0001 $01 1 
0010 $02 2 
0011 $03 3 
0100 $04 4 
0101 $05 5 
0110 $06 6 
0111 $07 7 
1000 $08 8 
1001 $09 ) 
1010 $0A  ~=:10 
1011 $0B ll 
1100 $0C =. 12 
1101 $0D =18 
1110 $0E 14 
1111 $OF Ib 


O One byte can represent any of 16 x 16 or 256 values. The value can be 
specified by exactly two hexadecimal digits. 


Oo Bits within a byte are numbered from bit 0 on the right to bit 7 on the left. 


O The bit number is the same as the power of 2 that it represents, in a 
manner completely analogous to the digits in a decimal number. 
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oO One memory position in the Apple Ile contains one eight-bit byte of data. 

oO How byte values are interpreted depends on whether the byte is an 
instruction in a language, part or all of an address, an ASCII code, or 
some other form of data. 

oO Two bytes make a word. The sixteen bits of a word can represent any 
one of 256 x 256 or 65536 different values. 

Oo The 65C02 uses a 16-bit word to represent memory locations. It can 
therefore distinguish among 65536 (64K) locations at any given time. 

o Amemory location is one byte of a 256-byte page. The low-order byte of 
an address specifies this byte. The high-order byte specifies the memory 
page the byte is on. 


Hexadecimal and Decimal 
a a ee 


Use Table E-2 for conversion of hexadecimal and decimal numbers. 


Table E-2. Hexadecimal/Decimal Conversion 


Digit $x000 $0x00 $00x0 $000x 


F 61440 3840 240 15 
07344 3004 224 14 
D 53248 3328 208 13 
C 49152 8072 192 12 
B 45056 2816 176 1] 
A 40960 2560 160 10 
9 36864 2304 144 9 
8 32768 2048 128 8 
ij 28672 1792 112 (f 
6 24576 1536 96 6 
4) 20480 1280 80) ) 
4 16384 1024 64 4 
3 12288 768 48 3 
2 8192 012 32 2 
4096 256 16 ] 
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To convert a hexadecimal number to a decimal number, find the decimal 
numbers corresponding to the positions of each hexadecimal digit. Write 
them down and add them up. 


Examples: 

$3C = ? $FD47 = ? 

$30 = 48 $F000 = 61449 

$09C = 12 $¢$ DO0 = 3328 

eee Sees $ 40 = 64 
$ 7s 7 

$3C = 66 9 Lon neeeeuuuee 


$FD47 = 64839 


To convert a decimal number to hexadecimal, subtract from the decimal 


number the largest decimal entry in the table that is less than the number. 


Write down the hexadecimal digit (noting its place value) also. Now 
subtract the largest decimal number in the table that is less than the 
decimal remainder, and write down the next hexadecimal digit. Continue 
until you have zero left. Add up the hexadecimal numbers. 


Example: 
16215 = $ ? 
1621S - 12288 = 3927 12288 = $7008 
3927 - 3848 = 87 3848 = $ FOB 
87 - 88 = 7 86 = $ SB 


7 7 = $ 7 
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Hexadecimal and Negative Decimal 

ee Se a a ee ee a eee se eee ee a ee ee ee 
If a number is larger than decimal 32767, Applesoft BASIC allows and 
Integer BASIC requires that you use the negative-decimal equivalent of the 
number. Table E-3 is set up to make it easy for you to convert a 
hexadecimal number directly to a negative decimal number. 


Table E-3. Hexadecimal to Negative Decimal Conversion 


Digit $x000 $$0x00 $$00x0 $$000x 


F 0 0 0 =i 
i -4096 -256 -16 -2 
D -8192 512 -32 -3 
C -12288 -768 -48 -4 
B -16384 -1024 -64 5 
A -20480 -1280 -80 6 
) -24576 -1536 -96 7 
8 -28672 -1792 -112 -8 
7 -2048 -128 9 
6 -2304 -144 -10 
D -2560 -160 -l] 
4 -2816 -176 -12 
3 -8072 -192 -13 
2 -38328 -208 -14 
l -3084 -224 -15 
0 -3840 -240) -16 


To perform this conversion, write down the four decimal numbers 
corresponding to the four hexadecimal digits (zeros included). Then add 
their values. The resulting number is the desired negative decimal number. 


Example: 

$CO18 = - ? 
$CH00: -12288 
$¢ 800: - 3848 
$ 10: - 224 
$¢ 6: - 16 
$C018 -16368 
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To convert a negative-decimal number to a positive decimal number, add it 
to 65536. (This addition ends up looking like subtraction. ) 


Example: 
-151 = + ? 
65536 + €-151) = 65536 - 151 = 65385 


To convert a negative-decimal number to a hexadecimal number, first 
convert it to a positive decimal number, then use Table E-2. 
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Graphics Bits and Pieces 


Table E-4 is a quick guide to the hexadecimal values corresponding to 7-bit 
high-resolution patterns on the display screen. Since the bits are displayed 
in reverse order, it takes some calculation to determine these val ues. 
Table E-4 should make it easy. 


Table E-4. Hexadecimal Values for High-Resolution Dot Patterns 


Bits in Data Byte Bit Pattern x=0 # x=1 Bit Pattern x=0 #£x=l 
x0000000 $00 $80 x0100000 $02 $82 
x0000001 $40 $C0 x0100001 $42 $C2 
x0000010 $20 $A0 x0100010 $22 $A2 
x0000011 $60 $0 x0100011 $62 $H2 
x0000100 $10 $90 x0100100 $12 $92 
x0000101 $50 $D0 x0100101 $52 $D2 
x0000110 $30 $B0 x0100110 $32 $B2 
x0000111 $70 $F0 x0100111 $72 $F2 

aC code, Seneea x0001000 $08 $88 x0101000 $0A $8A 
x0001001 $48 $C8 x0101001 $44 $CA 
x0001010 $28 $A8 x0101010 $2A $AA 
x0001011 $68 $58 x0101011 $64 $EA 
x0001100 $18 $98 x0101100 $1A  $9A 
x0001101 $58 $D8 x0101101 $54 §$DA 
x0001110 $38 $B8 x0101110 $3A $BA 
x0001111 $78 $F8 x0101111 $7A = SFA 
x0010000 $04 $84 x0110000 $06 $86 
x0010001 $44 $04 x0110001 $46 $C6 
x0010010 $24 $A4 x0110010 $26 $A6 
x0010011 $64 $h4 x0110011 $66 $K6 
x0010100 $14 $94 x0110100 $16 $96 
x0010101 $54 $D4 x0110101 $56 $D6 
x0010110 $34 $B4 x0110110 $36 $B6 
x0010111 $74 $F4 x0110111 $76 $F6 
x0011000 $0C $80 x0111000 SOE $8E 
x0011001 $40  $CC x0111001 $4—  $CE 
x0011010 $2C $AC x0111010 $2E $A 
x0011011 $6C  $EC x0111011 $6E $EE 
x0011100 $10  $9C x0111100 $1E $98 
x0011101 $5C  $DC x0111101 $5E $DE 
x0011110 $380 $BC x0111110 $3E  $BE 
x0011111 $7C  $FC xO111111 $7E =: $FE 
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The x represents bit 7. Zeros represent bits that are off; ones bits that are 
on. Use the first hexadecimal value if bit 7 is to be off, and the second if it is 
to be on. 


For example, to get bit pattern 00101110, use $3A; for 10101110, use $BA. 


Table E-4—Continued. Hexadecimal Values for High-Resolution Dot Patterns 


Bit Pattern x=0 # x=1l Bit Pattern x=0 #£x=1 
x 1000000 $01 $81 x1100000 $03 $83 

x1000001 $41 $C1 x1100001 $43 $03 
x1000010 $21 $Al x1100010 $23 $A3 
x1000011 $61 $E1 x1100011 $63 $E3 
x1000100 $11 $91 x1100100 $13 $93 

x1000101 $51 $D1 x1100101 $53 $D3 
x1000110 $31 $B1 x1100110 $33 $B3 
x1000111 $71 $F1 x1100111 $73 $F3 
x 1001000 $09 $89 x1101000 $0B  $8B 
x1001001 $49 $C9 x1101001 $4B $CB 
x1001010 $29 $A9 x1101010 $2B $AB 
x1001011 $69 $E9 x1101011 $6B $EB 
x1001100 $19 $99 X1101100 $1B $9B 
x1001101 $59 $D9 x1101101 $5B $DB 
x1001110 $39  $B9 x1101110 $3B $BB 
x1001111 $79 $F9 X1101111 $7B $FB 
x1010000 $05 $85 x1110000 $07 $87 

x1010001 $45 $C5 x1110001 $47 $C7 
x1010010 $25 $A5 X1110010 $27 $A7 
x1010011 $65 $E5 X1110011 $67 $E7 
x1010100 $15 $95 x1110100 $17 $97 

x1010101 $55 $D5 X1110101 $57 $D7 
x1010110 $35 $B5 X1110110 $37 $B7 
x1010111 $75 $F5 x1110111 $77 $F7 

x1011000 $0D $8D x1111000 $0F $8F 

x1011001 $4D $CD x1111001 $4F $CF 
x1011010 $2D $AD x1111010 $2F SAF 
x1011011 $6D $ED x1111011 $6F SEF 
x1011100 $1D $9D x1111100 $1F $9F 

x1011101 $5D $DD x1111101 $5F $DF 
x1011110 $3D $BD X1111110 $3F $BF 
x1011111 $7D $FD xl111111 $7F $FF 
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Eight-Bit Code Conversions 

RR a ae a ae ee 
Tables E-5 through K-12 show the entire ASCII character set twice: once 
with the high bit off, and once with it on. Here is how to interpret these 
tables. 


O 
C) 


The MouseText characters are shown in 
Table E-7. 


The Binary column has the 8-bit code for each ASCII character. 

The first 128 ASCII entries represent 7-bit ASCII codes plus a high-order 
bit of 0 (SPACE parity or Pascal)—for example, 010010000 for the 

letter . 

The last 128 ASCII entries (from 128 through 255) represent 7-bit ASCII 
codes plus a high-order bit of 1 (MARK parity or BASIC)—for example, 
11001000 for the letter H. 

A transmitted or received ASCII character will take whichever form is 
appropriate if odd or even parity is selected—for example, 11001000 for 
an odd-parity H, 01001000 for an even-parity H. 

The ASCII Char column gives the ASCII character name. 

The /nterpretation column spells out the meaning of special symbols 
and abbreviations, where necessary. 

The What to Type column indicates what keystrokes generate the ASCII 
character (where it is not obvious). 

The columns marked P77 and Alt indicate what displayed character 
results from each code when using the primary or alternate display 
character set, respectively. Boldface is used for inverse characters; italic 
is used for flashing characters. 


Note that the values $40 through $5F (and $CO through $DF) in the 
alternate character set are displayed as MouseText characters if 
MouseText is turned on. 
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Note: The primary and alternate displayed character sets in Tables E-5 
through E-12 are the result of firmware mapping. The character generator 
ROM actually contains only one character set. The firmware mapping 
procedure is described in the section “Inverse and Flashing Text,” in 
Chapter 3. 


Table E-5. Control Characters, High Bit Off 


ASCII 
Binary Dec Hex Char Interpretation What to Type Pri Alt 
0000000 0 $00 NUL Blank (null) (CONTROL }[@] 
0000001 1 $01 SOH Start of Header 
0000010 2 $02 STX Start of Text 
0000011 3 $03 ETX End of Text 
0000100 4 $04 EOT End of Transm. (CONTROL }(D] 
0000101 5 $05 ENQ Enquiry (CONTROL HE] 
0000110 6 $06 ACK Acknowledge 
0000111 fi $07 BEL Bell (CONTROL }{G] 
0001000 8 $08 BS Backspace (CONTROL }{H] or [=] 
0001001 9 $09 HT Horizontal Tab (CONTROL }{1] Or 
0001010 10 $0A LF Line Feed or] 
0001011 11 $0B VT Vertical Tab (CONTROL }{Kk] or [7] 
0001100 12 $0C FF Form Feed 
0001101 13 $0D CR Carriage Return (CONTROL }(M] Or 
0001110 14 $0E SO Shift Out (CONTROL }(N] 
0001111 15 SOF SI Shift In (CONTROL }{O] 


0010000 16 $10 DLE Data Link Escape = (CONTROLHP] 
0010001 17 $11 DCl Device Control 1 (CONTROL }([Q] 
0010010 18 $12 DC2 Device Control 2 (CONTROL }(R] 
0010011 19 $13 DC3 Device Control 3 [CONTROL }{S] 
0010100 20 $14 DC4 Device Control 4 
0010101 21 $15 NAK Neg. Acknowledge or (=} 
0010110 22 $16 SYN Synchronization 
0010111 28 $17 ETB Endof Text Blk. (ConTROL}(W] 


EHIME MES OHE MR ROVOZZM AU TOA SMOOWE® 
INK MEOH RDOVOZZM AUTO AMO OWPEA 


0011000 24 $18 CAN Cancel 

0011001 25 $19 EM End of Medium 

0011010 26 $14 SUB Substitute (CONTROL }{Z] 

0011011 27 $1B ESC Escape (CONTROL HT) or 

0011100 28 $1C FS File Separator 

0011101 29 $1D GS Group Separator (CONTROL }(7] 

0011110 30 $1E RS Record Separator 

001111] 31 $1F US Unit Separator [CONTROL }{_ ] = = 
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Table E-6. Special Characters, High Bit Off 


Binary 


0100000 
0100001 
0100010 
0100011 
0100100 
0100101 
0100110 
0100111 
0101000 
0101001 
0101010 
0101011 
0101100 
0101101 
0101110 
0101111 
0110000 
0110001 
0110010 
0110011 
0110100 
0110101 
0110110 
0110111 
0111000 
0111001 
0111010 
0111011 
0111100 
0111101 
0111110 
Ol11111 
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Dec 


32 
33 
34 
i) 
36 
3¢ 
38 
39 
40) 
4] 
42 
43 
44 
45 
46 
47 
48 
49 
50 
ol 
52 
OB 
o4 
OD 
56 
ot 
58 
a9 
60 
61 
62 
63 


Hex 


$20 
$21 
$22 
$23 
$24 
$25 
$26 
$27 
$28 
$29 
$2A 
$2B 
$2C 
$2D 
$2E 
$2F 
$30 
$31 
$32 
$33 
$34 
$35 
$36 
$37 
$38 
339 
S3A 
$3B 
$3C 
$3D 
$3E 
$3F 


ASCII 
Char 


SP 


coon ooo — Gt YOK O™.* 


Sy At 


Interpretation 


Space 


Closing Quote 


Comma 
Hyphen 
Period 
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Pri 


a aa * Qo se wm } 


ee OON OO fH — OS™" 


s\n An 


conan rh, OD = S™°* 


~~. © ee 


aril 


Table E-7. Uppercase Characters, High Bit Off 


Binary 


1000000 
1000001 
1000010 
1000011 
1000100 
1000101 
1000110 
1000111 
1001000 
1001001 
1001010 
1001011 
1001100 
1001101 
1001110 
1001111 
1010000 
1010001 
1010010 
1010011 
1010100 
1010101 
1010110 
1010111 
1011000 
1011001 
1011010 
1011011 
1011100 
1011101 
1011110 
1011111 


Dec 


64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
9] 
92 
93 
94 
95 


Hex 


$40 
341 
$42 
$43 
$44 
$45 
$46 
$47 
$48 
$49 
S4A 
$4B 
$4C 
$4D 
$45 
S4F 
$50 
$5] 
$52 
$53 
$54 
$55 
$56 
$57 
$58 
$59 
$5A 
$5B 
$5C 
$5D 
$5E 
$5F 


ASCII 
Char 


@ 


STATIN KM SM CHNDOVOSAZZMACT*IOBVWMmOADS 


Interpretation 


Opening Bracket 
Reverse Slant 
Closing Bracket 
Caret 

Underline 


Kight-Bit Code Conversions 


a 
a. 


»~—~NwWRSETOIVVBOVOSOSARSORS SERBS avre® 


E 


lde: TeéRN< My O® 


Fl lO_UNRR LV I 2eve et 
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Table E-8. Lowercase Characters, High Bit Off 


Binary 


1100000 
1100001 
1100010 
1100011 
1100100 
1100101 
1100110 
1100111 
1101000 
1101001 
1101010 
1101011 
1101100 
1101101 
1101110 
1101111 
1110000 
1110001 
1110010 
1110011 
1110100 
1110101 
1110110 
1110111 
1111000 
1111001 
1111010 
1111011 
1111100 
1111101 
1111110 
1111111 
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Dec 


96 

97 

98 

99 

100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
11] 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 


Hex 


$60 
$61 
$62 
$63 
$64 
$65 
$66 
$67 
$68 
$69 
$6A 
$6B 
$6C 
$6D 
$6E 
$6F 
$70 
$71 
$72 
$73 
$74 
$75 
$76 
377 
$78 
$79 
$7A 
$7B 
$7C 
$7D 
$7E 
STF 


ASCII 
Char 


i ee i —sovpos7 3 TK Soa rm DO 6 Oo & 


DEL 


Interpretation What to Type 


Opening Quote 


Opening Brace 
Vertical Line 
Closing Brace 
Overline (Tilde) 
Delete /Rubout 
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Pri 


~ Go sO & + yo 


+ #*#~™~N 


’ “ee 


Co %\ D GT GO AD ~~ DO" 


Vl Ar 


tr ~~ ~N Md oe Gd so ta Mew OD Rm eee son ho AO Oo & 


DEL 


Table E-9. Control Characters, High Bit On 


Binary 


10000000 
10000001 
10000010 
10000011 
10000100 
10000101 
10000110 
10000111 
10001000 
10001001 
10001010 
10001011 
10001100 
10001101 
10001110 
10001111 
10010000 
10010001 
10010010 
10010011 
10010100 
10010101 
10010110 
10010111 
10011000 
10011001 
10011010 
10011011 
10011100 
10011101 
10011110 
10011111 


Hex 


$80 
$81 
$82 
$83 
$84 
$85 
$86 
$87 
$88 
389 
$8A 
$8B 
$8C 
38D 
$8E 
SOF 
$90 
$91 
$92 
$93 
$94 
$95 
$96 
$97 
$98 
$99 
S9A 
$9B 
$9C 
$9D 
$9E 
SOF 


ASCII 
Char 


NUL 
SOH 
STX 
ETX 
KOT 
ENQ 
ACK 
BEL 
BS 
HT 
LF 
VT 
FE 
CR 
SO 
SI 
DLE 
DC1 
DC2 
DC3 
DC4 
NAK 
SYN 
KTB 
CAN 
KM 
SUB 
KSC 
FS 
GS 
RS 
US 


Interpretation 


Blank (null) 
Start of Header 
Start of Text 
End of Text 

End of Transm. 
Enquiry 
Acknowledge 
Bell 

Backspace 
Horizontal Tab 
Line Feed 
Vertical Tab 
Form Feed 
Carriage Return 
Shift Out 

Shift In 

Data Link Escape 
Device Control 1 
Device Control 2 
Device Control 3 
Device Control 4 
Neg. Acknowledge 
Synchronization 
End of Text BIk. 
Cancel 

End of Medium 
Substitute 
Escape 

File Separator 
Group Separator 
Record Separator 
Unit Separator 


What to Type 


[CONTROL }{ @} 
[CONTROL }{A] 
[CONTROL }{B] 
[CONTROL }{C] 
[CONTROL }[D] 
[CONTROL }[E 
[CONTROL }{F ] 
[CONTROL }{G] 


[CONTROL }{H] OF [=] 
[CONTROL }{1 J or [TAB] 


[conTROL }[J] or [+] 
[CONTROL }{K] or [1] 
[CONTROL }{L] 


[CONTROL }(M ] OF [RETURN ] 


[CONTROL }[N] 
[CONTROL }[0] 
[CONTROL }{P] 
[CONTROL }(Q} 
[CONTROL }{R] 
[CONTROL }[S] 
[CONTROL }[T] 


[CONTROL }{U] or [=] 


[CONTROL }{ Vv] 
[CONTROL }{W] 
[CONTROL }[x] 
[CONTROL }{Y } 
[CONTROL }{Z] 


[CONTROL }[[) or [ESC] 


[CONTROL }[\ 
[CONTROL }{1) 
[CONTROL }{*] 
[CONTROL }{_] 


Eight-Bit Code Conversions 


a) 
=f 


TW NK KM SSC NMDHOTVOAZZUMATT AOI aAW Se) 


= 
et 


TAT N KM SES CHNDOVOZZO ACTA SMV AOWS® 
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Table E-10. Special Characters, High Bit On 


Binary 


10100000 
10100001 
10100010 
10100011 
10100100 
10100101 
10100110 
10100111 


10101000 
10101001 
10101010 
10101011 
10101100 
10101101 
10101110 
10101111 
10110000 
10110001 
10110010 
10110011 
10110100 
10110101 
10110110 
10110111 
10111000 
10111001 
10111010 
10111011 
10111100 
10111101 
10111110 
10111111 


200 


Hex 


$A0 
$Al 
$A2 
$A3 
$A4 
SA5 
$A6 
SAT 


$A8 
$A9 
SAA 
SAB 
SAC 
SAD 
SAB 
SAF 
$B0 
$B] 
$B2 
$B3 
$B4 
$B5 
$B6 
$B7 
$B8 
$B9 
SBA 
SBB 
SBC 
$BD 
SBE 
SBF 


ASCII 
Char 


SP 


oon rP where O™* 


sy if ye he 


Interpretation 


Space SPACE bar 


Closed Quote 
(acute accent) 


Comma 
Hyphen 
Period 
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What to Type 


cjooon oof GC HR O™." 


Sy At” 


co CO SI SO OTS G DO O™.°* + *wrn 


Vy At 


Table E-11. Uppercase Characters, High Bit On 


Binary 


11000000 
11000001 
11000010 
11000011 
11000100 
11000101 
11000110 
11000111 
11001000 
11001001 
11001010 
11001011 
11001100 
11001101 
11001110 
11001111 
11010000 
11010001 
11010010 
11010011 
11010100 
11010101 
11010110 
11010111 
11011000 
11011001 
11011010 
11011011 
11011100 
11011101 
11011110 
11011111 


Dec 


192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 


Hex 


$0 
$Cl 
$02 
$03 
$C4 
$C5 
$C6 
$C7 
$C8 
$C9 
$CA 
$CB 
$CC 
$CD 
$CE 
$CF 
$D0 
$D1 
$D2 
$D3 
$D4 
$D5 
$D6 
$D7 
$D8 
3D9 
SDA 
SDB 
$DC 
$DD 
$DE 
$DF 


ASCII 
Char 


@ 


TATN KM SAK CHNRDOVOAZMACTMIOIMwSOWS 


Interpretation 


Opening Bracket 
Reverse Slant 
Closing Bracket 
Caret 

Underline 


Eight-Bit Code Conversions 


a 
=F 


STAT NK ES CHNADOVOZZORO“TOIMIAWSE 


= 
et 
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Table E-12. Lowercase Characters, High Bit On 


Binary 


11100000 
11100001 
11100010 
11100011 
11100100 
11100101 
11100110 
11100111 
11101000 
11101001 
11101010 
11101011 
11101100 
11101101 
11101110 
11101111 
11110000 
11110001 
11110010 
11110011 
11110100 
11110101 
11110110 
11110111 
11111000 
11111001 
11111010 
11111011 
11111100 
11111101 
11111110 
Hill 


202 


Dec 


224 
220 
226 
227 
228 
229 
230 
23] 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
250 


Hex 


SEO 
$1 
$E2 
$E3 
$E4 
SE5 
SE6 
SE7 
SES 
SEQ 
SEA 
SEB 
SEC 
SED 
SEE 
SEF 
SFO 
$F 1 
$F2 
$F3 
SF4 
SF5 
3F6 
SF7 
SF8 
SF9 
SFA 
SFB 
SFC 
$FD 
SFE 
SFF 


ASCII 
Char 


an ee a i a — —-ovpvo Ss 38 Tna™ ao mm 0 f.O oF & 


DEL 


Interpretation What to Type 


Open Quote 


Opening Brace 

Vertical Line 

Closing Brace 

Overline (Tilde) 

Delete (Rubout) DELETE 
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, 
= 


Alt 


pT WAN SS SM BES ETH ODO S ATA TTA se OA oh 
PTT TWINK KM ESS TMB ODOR AZ TAH TA eo ao oO 


DEL DEL 


Appendix F Frequently Used Tables 


This appendix contains copies of the tables you will need to refer to 
frequently, for example, ASCII codes and soft-switch location. The figures 
all have their original figure numbers. 


Table 2-3. Keys and ASCII Codes 


Note: Codes are shown here in hexadecimal; to find the decimal equival ents, refer 
to Table E-2. 


Normal Control Shift Both 
Key Code Char Code Char Code Char Code Char 


(F DEL 7F DEL F DEL 7F DEL 
03 BS 08 BS 08 BS 08 BS 
09 HT O09 HT 09 HT 09 HT 
o 0A LF OA LF OA LF. OA LF 
a 0B VT oB VT OB VI OB. VT 
0 CR OD CR OD CR OD CR 
=] 15  NAK 15 NAK 15 NAK 15 NAK 
IB ESC 1B ESC 1B ESC 1B ESC 
20 SP 0 SP 2 SP 20  °& SP 


” 27 27 Ys . Ze : 
,< 2C 20 , 3C <— 3C < 
- 2D - lF US oF = IF US 
> 2E 2E 3E = 3k > 
ye 2F / 2F / OF : oF : 
0) 30 «0 30 0 299 ~~ «CY 29 ) 
1 31 l 31 l 21 | 21 | 
2@ 320 00 NU 4 #£=@ 00 NUL 
3 # 30 3 33 5) 23 # ye # 
4$ 34 4 34 4 24 $ 24 $ 
5% 35 D BD D 25 % 25 % 
6 36 6 IE ~—sRS 5E : 1E RS 
7& OL ‘i 37 ij 26 & 26 & 
8 * 38 8 38 8 2A : 2A . 
9 ( 39 ) 39 g 28 ( 28 ( 
3B 3B 3A 3A 
= + 38D = 3D = 2B + 2B “- 
{ 5B 1B ESC 7B { 1B ESC 
\ | 5C \ 1C FS 7C | 1C FS 
|} 5D 1D GS 7D \ 1D GS 
60 60 7E 7E 
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Table 2-3—Continued. Keys and ASCII Codes 


Note: Codes are shown here in hexadecimal, to find the decimal equivalents, refer 
to Table E-2. 


Normal Control Shift Both 
Key Code Char Code Char Code Char Code Char 
A 61 a 01 SOH 41 A 01 SOH 
B 62 b 02 STX 42 B 2 STX 
C 63 c 03 ETX 43 C 03 ETX 
D 64 d 04 EOT 44 D (4 EOT 
E 65 e 05 ENQ 45 E, 05 ENQ 
F 66 f 06 ACK 46 F 06 ACK 
G 67 g 07 BEL 47 G 07 BEL 
H 68 h 08 BS 48 H 08 BS 
| 69 1 09 HT 49 I 09 HT 
J 6A j OA LF 4A J OA LF 
K 6B k OB VT 4B K OB VT 
L 6C l OC FF 4C L OC FF 
M 6D m OD CR 4D M OD CR 
N 6E n OE SO 4 N OE SO 
O 6F 0 OF S] 4F O OF SI 
P 70 D 10 DLE 50 P 10 DLE 
Q (a q 1] DCl ol Q) ll DC1 
R 72 r [2 DC2 D2 R 12 DC2 
S 13 S 13 DC3 D3 S 13 DC3 
T 74 t 14 DC4 o4 il 14 DC4 
U 15 u 15 NAK dO U 15 NAK 
1) 76 V 16 SYN 56 V 16 SYN 
W ai Ww 17 ETB 57 W 17 ETB 
X 18 X 18 CAN 58 X 18 CAN 
Y 79 y 19 EM 59 Y 19 EM 
Zs 1A Z 1A SUB 5A ZL 1A SUB 


Table 2-2. Keyboard Memory Locations 


Location 
Hex Decimal Description 


$Cc000 49152 -16884 Keyboard data and strobe 
$0010 49168 - -16368 Any-key-down flag and clear-strobe switch 
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256 


Table 2-4. Video Display Specifications 


Display modes: 


Text capacity: 
Character set: 


Display formats: 


Low-resolution graphics: 


High-resolution graphics: 


Double-high-resolution 
graphics: 


40-column text; map: Figure 2-2 
80-column text; map: Figure 2-3 


Low-resolution color graphics; map: Figure 2-7 
High-resolution color graphics; map: Figure 2-8 


Double-high-resolution color graphics; 
map: Figure 2-9 


24 lines by 80 columns (character positions) 
96 ASCII characters (uppercase and lowercase) 
Normal, inverse, flashing, MouseText (Table 2-5) 


16 colors (Table 2-6) 40 horizontal by 48 vertical; 
map: Figure 2-7 


6 colors (Table 2-7) 140 horizontal by 192 vertical 
(restricted) 


Black-and-white: 280 horizontal by 192 vertical; 
map: Figure 2-8 


16 colors (Table 2-8) 140 horizontal by 192 vertical 
(no restrictions) 


Black-and-white: 560 horizontal by 192 vertical: 
map: Figure 2-9 
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Table 2-8. Double-High-Resolution Graphics Colors 


Repeated 

Color ab0 mb1l ab2 mb3 Bit Pattern 
Black $00 $00 $00 $00 0000 
Magenta $08 $11 $22 $44 0001 
Brown $44 $08 $11 $22 0010 
Orange $40 $19 $33 $66 0011 
Dark Green $22 $44 $08 $1] 0100 
Gray 1 $2.A $55 $2A $55 0101 
Green $66 $4C $19 $33 0110 
Yellow $6E $5D $3B $77 0111 
Dark Blue $11 $22 $44 $08 1000 
Purple $19 $33 $66 $4C 1001 
Gray 2 $55 $2A $55 $2A 1010 
Pink $5D $3B $77 $6E 1011 
Medium Blue $33 $66 $4C $19 1100 
Light Blue $3B $77 $6E $5D 1101 
Aqua $77 $6E $5D $3B 1110 
White $7F $7F $7F $7F 1111 
Table 2-9. Video Display Page Locations 

Display Lowest Address Highest Address 
Display Mode Page Hex Dec Hex Dec 
40-column text, l $0400 1024 $O7FF 2047 
low-resolution iu $0800 2048 $OBFF 3071 
graphics 
80-column text 1 $0400 1024 SO7FF 2047 

a $0800 2048 $OBFF 3071 
High-resolution l $2000 8192 $3FFF 16383 
graphics 2 $4000 16384 $5FFF 24575 
Double-high- 1t $2000 8192 $3FFF 16383 
resloution graphics af $4000 163884 $5FFF 24575 


* This is not supported by firmware; for instructions on how to switch pages, refer to the 
section “Display Mode Switching” in Chapter 2. 


t See the section “Double-High-Resolution Graphics,” in Chapter 2. 
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Table 2-10. Display Soft Switches 


Note: W means write anything to the location, R means read the location, R/W 
means read or write, and R7 means read the location and then check bet 7. 


Name 


ALTCHAR 
ALTCHAR 


RDALTCHAR 


80COL 
80COL 
RD80COL 


80STORE 
80STORE 


RD80STORE 


PAGE2 
PAGE2 


RDPAGE2 


TEXT 
TEXT 
RDTEXT 


MIXED 
MIXED 
RDMIXED 


HIRES 
HIRES 


RDHIRES 
IOUDIS 


IOUDIS 


RDIOUDIS 


DHIRES 
DHIRES 
RDDHIRES 


Action Hex 
W $CO0E 
W $COOF 
R7 $CO1E 
W $COOC 
W $CO0D 
R7 $COIF 
W $C000 
W $0001 
R7 $C018 
R/W $C054 
R/W $C055 
R7 $C01C 
R/W $C050 
R/W $C051 
R7 $CO1A 
R/W = $C052 
R/W $C053 
R7 $CO1B 
R/W $C056 
R/W = $C059 
R7 $C01D 
$CO7E 
$CO7F 
R7 $CO7E 
R/W $CO05E 
R/W $CO5F 
R7 $CO7F 


Function 


Off: display text using primary character set 
On: display text using alternate character set 
Read ALTCHAR switch (1 = on) 


Off: display 40 columns 
On: display 80 columns 
Read 80COL switch (1 = on) 


Off: cause PAGEZ2 on to select auxiliary RAM 
On: allow PAGE2 to switch main RAM areas 
Read 80STORE switch (1 = on) 


Off: select Page 1 

On: select Page 2 or, if 80STORE on, Page 1 in 
auxiliary memory 

Read PAGE2 switch (1 = on) 


Off: display graphics or, if MIXED on, mixed 
On: display text 
Read TEXT switch (1 = on) 


Off: display only text or only graphics 
On: if TEXT off, display text and graphics 
Read MIXED switch (1 = on) 


Off: if TEXT off, display low-resolut ion graphics 
On: if TEXT off, display high-resoluttion or, if 
DHIRES on, double-high-resolution graphics 
Read HIRES switch (1 = on) 


On: disable IOU access for addresses $C058 to 
$CO5F; enable access to DHIRES sw itch * 

Off: enable IOU access for addresses $C058 to 
$CO5F: disable access to DHIRES switch * 
Read IOUDIS switch (1 = off) t 


On: (if IOUDIS on) turn on double-high-res. 
Off: Gif IOUDIS on) turn off double-high-res. 
Read DHIRES switch (1 = on) f 


* The firmware normally leaves IOUDIS on. See also T. 


+ Reading or writing any address in the range $C070-$C07F also triggers the p-addle timer 
and resets VBLINT (Chapter 7). 
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Table 3-1. Monitor Firmware Routines 


Location 


$0305 


$0307 


SFC9C 
SFC9E 


SFC42 
$F832 
$F836 
$FDED 


SFDFO 
$F D8E 
$FD8B 


SFD6A 


F819 
SFC58 


$FDIB 


F800 
SFO4A 
$FDDA 
$FF2D 
$FDE3 
$941 
$FDOC 


F871 
SF 864 
$FC24 
$F828 


Name 


BASICIN 


BASICOUT 


CLREOL 
CLEOLZ 


CLREOP 
CLRSCR 
CLRTOP 
COUT 


COUT] 
CROUT 
CROUT] 


GETLN 


HLINE 
HOME 


KEYIN 


PLOT 
PRBL2 
PRBYTE 
PRERR 
PRHEX 
PRNTAX 
RDKEY 


SCRN 
SETCOL 
VTABZ 
VLINE 


Description 
With 80-column dirmware active, displays solid, blinking 
cursor. Accepts character from keyboard. 


Displays a character on the screen; used when the 
80-column firmware is active (Chapter 8). 


Clears to end of line from current cursor position. 


Clears to end of line using contents of Y register as cursor 
position. 


Clears to bottom of window. 
Clears the low-resolution screen. 
Clears top 40 lines of low-resolution screen. 


Calls output routine whose address is stored in CSW 
(normally COUT1, Chapter 3). 


Displays a character on the screen (Chapter 3). 
Generates a carriage return character. 


Clears to end of line, then generates a carriage return 
character. 


Displays the prompt character; accepts a string of 
characters by means of RDKEY. 


Draws a horizontal line of blocks. 


Clears window; puts cursor in upper-left corner of 
window. 


With 80-column firmware inactive, displays 
checkerboard cursor. Accepts character from keyboard. 


Plots a single low-resolution block on the screen. 
Sends 1 to 256 blank spaces to the output device. 
Prints a hexadecimal byte. 

Sends ERR and Control-G to the output device. 
Prints 4 bits as a hexadecimal number. 

Prints contents of A and X in hexadecimal. 


Displays blinking cursor; goes to standard input routine, 
normally KEYIN or BASICIN. 


Reads color value of a low-resolution block. 
Sets the color for plotting in low-resolution. 
Sets cursor vertical position. 

Draws a vertical line of low-resolution blocks. 
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Table 3-38a. Control Characters With 80-Column Firmware Off 


Control 
Character 


Control-G 


Control-H 


Control-J 


Control-M 


ASCII 
Name 


BEL 
BS 


LF 


CR 


Apple Ile 
Name 


bell 
backspace 


line feed 


return 


Action Taken by COUT1 
Produces a 1000 Hz tone for 0.1 second. 


Moves cursor position one space to the 
left; from left edge of window, moves to 
right end of line above. 


Moves cursor position down to next line in 
window; scrolls if needed. 


Moves cursor position to left emd of next 
line in window; scrolls if needed. 


Table 3-3b. Control Characters With 80-Column Firmware On 


Control 
Character 


Control-G 
Control-H 


Control-J 


Control-K ¢ 


Control-L f 


Control-M 


Control-N ¢ 
Control-O t 
Control-Q tf 
Control-R t 


Control-S * 


ASCII Apple Ie 
Name Name 


BEL 


BS 


LF 


VT 


FF 


OR 


SO 
SI 
DCl 
DC2 
DC3 


bell 


backspace 


line feed 


clear EOS 


home 
and clear 


return 


normal 
inverse 
40-column 
80-column 


stop-list 
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Action Taken by BASICOUT 
Produces a 1000 Hz tone for 0.1 second. 


Moves cursor position one space to the 
left; from left edge of window, moves to 
right end of line above. 


Moves cursor position down to next line in 
window; scrolls if needed. 


Clears from cursor position to the end of 
the screen. 


Moves cursor position to upper-left corner 
of window and clears window. 


Moves cursor position to left exd of next 
line in window; scrolls if needed. 


Sets display format normal. 
Sets display format inverse. 
Sets display to 40-column. 
Sets display to 80-column. 


Stops listing characters on the display 
until another key is pressed. 


Table 3-3b—Continued. Control Characters With 80-Column Firmware On 


Control 
Character 


Control-U t 
Control-V f¢ 


Control-W + 


Control-X 


Control-Y tf 


Control-Z f 
Control-| 


Control-\ 


Control-]t 


Control-_ 


ASCII Apple Ile 
Name Name 


NAK — quit 
SYN © scroll 


ETB _ scroll-up 
CAN disable 
MouseText 


EM home 


SUB clear line 


ESC enable 
MouseText 

FS forward 
space 


GS clear EOL 


US up 


* Only works from the keyboard. 


t Doesn't work from the keyboard. 


Action Taken by BASICOUT 
Deactivates 80-column video firmware. 


Scrolls the display down one line, leaving 
the cursor in the current position. 


Scrolls the display up one line, leaving the 
cursor in the current position. 


Disable MouseText character display; use 
inverse uppercase. 


Moves cursor position to upper-left corner 
of window (but doesn’t clear). 


Clears the line the cursor position is on. 


Map inverse uppercase characters to 
MouseText characters. 


Moves cursor position one space to the 
right; from right edge of window, moves it 
to left end of line below. 


Clears from the current cursor position to 
the end of the line (that is, to the right 
edge of the window). 


Moves cursor up a line, no scroll. 


Table 3-5. Text Format Control Values 


Note: These mask values apply only to the primary character set (see text). 


Mask Value 
Dec Hex 
255 SFF 
127 $7F 
63 $3F 


Display Format 


Normal, uppercase, and lowercase 


Flashing, uppercase, and symbols 


Inverse, uppercase, and lowercase 
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Table 3-6. Escape Codes 


Escape Code 
[e] 


[Esc ][A]}or [a] 

(Esc ](B) or [b} 

[esc }[C}or(c} 

[esc }(0}or (a) 

(esc }(E}or[e) 
(esc }(F) or (£) 
[esc] J or (i) or Cesc} (+) 
[esc }(J) or {J or (esc }[~} 
(Esc) (k] or {k) or (Esc }(=] 
(esc ](M)or{m] or (esc }(+) 
[esc }(4] 


CONTROL }/D_ 


[ESC ][CONTROL }{E] 
[ESC ][CONTROL}[Q] 
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Function 


Clears window and homes cursor (places it in upper-left corner of screen), then exits from 
escape mode. 


Moves cursor right one line; exits from escape mode. 

Moves cursor left one line; exits from escape mode. 

Moves cursor down one line; exits from escape mode. 

Moves cursor up one line; exits from escape mode. 

Clears to end of line; exits from escape mode. 

Clears to bottom of window; exits from escape mode. 

Moves the cursor up one line; remains in escape mode. See text. 
Moves the cursor left one space; remains in escape mode. See text. 
Moves the cursor right one space; remains in escape mode. See text. 
Moves the cursor down one line; remains in escape mode. See text. 


If 80-column firmware is active, switches to 40-column mode; sets links to BASICIN and 
BASICOUT; restores normal window size; exits from escape mode. 


If 80-column firmware is active, switches to 80-column mode; sets links to BASICIN and 
BASICOUT; restores normal window size; exits from escape mode. 


Disables control characters; only carriage return, line feed, BELL, and backspace have an 
effect when printed. 


Reactivates control characters. 


If 80-column firmware is active, deactivates 80-colunm firmware; sets links to KEYIN and 
COUT]; restores normal window size; exits from escape mode. 
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Table 3-10. Pascal Video Control Functions 


Control- 


Kore 
Forf 
Gorg 
Horh 


Jorj 
Kork 
Lor | 
Morm 


Norn 
O oro 


Vorv 
W or w 
Yory 
Zorz 


lor \ 


bor] 


a~ 


or 6 
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Hex 
$05 
$06 
$07 
$08 


SOA 
$0B 
$0C 
$0D 
$0E 


SOF 


$16 
$17 
$19 
SIA 
$1C 


$1D 


$S1E 


SIF 


Function performed 

Turns cursor on (enables cursor display). 
Turns cursor off (disables cursor display). 
Sounds bell (beeps). 


Moves cursor left one column. If cursor was at 
beginning of line, moves it to end of previous line. 


Moves cursor down one row; scrolls if needed. 
Clears to end of screen. 

Clears screen; moves cursor to upper-left of screen. 
Moves cursor to column 0. 


Displays subsequent characters in normal video. 
(Characters already on display are unaffected. ) 


Displays subsequent characters in inverse video. 
(Characters already on display are unaffected. ) 


Scrolls screen up one line; clears bottom line. 

Scrolls screen down one line; clears top line. 

Moves cursor to upper-left (home) position on screen. 
Clears entire line that cursor is on. 


Moves cursor right one column, if at end of line, does 
Control-M. 


Clears to end of the line the cursor is on, including 
current cursor position; does not move cursor. 


GOTOxy: initiates a GOTOxy sequence; interprets the 
next two characters as x+32 and y+382, respectively. 


If not at top of screen, moves cursor up one line. 
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Table 4-6. Bank Select Switches 


Note: R means read the location, W means write anything to the location, R/W 
means read or write, and R7 means read the location and then check bit 7. 


Name 


RDBNK2 
RDLCRAM 


ALTZP 
ALTZP 


RDALTZP 
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Action 


Hex 

$C080 
$C081 
$0082 
$C083 
$C088 
$C089 
$CO8A 
$C08B 
$C011 
$0012 
$C008 
$C009 
$0016 


Function 

Read RAM; no write; use $D000 bank 2. 
Read ROM; write RAM; use $D000 bank 2. 
Read ROM; no write; use $D000 bank 2. 
Read and write RAM; use $D000 bank 2. 
Read RAM; no write; use $D000 bank 1. 
Read ROM; write RAM; use $D000 bank 1. 
Read ROM; no write; use $D000 bank 1. 
Read and write RAM; use $D000 bank 1. 
Read whether $D000 bank 2 (1) or bank 1 (0) 
Reading RAM (1) or ROM (0). 

Off: use main bank, page 0 and page 1. 
On: use auxiliary bank, page 0 and page 1. 


Read whether auxiliary (1) or main (0) bank 


Table 4-7. Auxiliary-Memory Select Switches 


Location 
Name Function Hex Decimal Notes 
RAMRD _ Read auxiliary memory $003 49155 = -16881 Write 
Read main memory $002 49154 -16382 Write 
Read RAMRD switch $C013 49171 -16865 Read 
RAMWRT Write auxiliary memory $C005 49157 -16379 Write 
Write main memory $0004 49156 -16380 Write 
Read RAMWRT switch $0014 49172 -163854 Read 
80STORE On: access display page $C001 49158 -16883 Write 
Off: use RAMRD, RAMWRT — $C000 49152 -16384 Write 
Read 80STORE switch $C018 49176 -16860 Read 


PAGE2 Page 2 on (aux. memory) $C055 49237-16299 * 
Page 2 off (main memory) $C054 49236 -16800 * 
Read PAGE2 switch $COIC 49180 -16356 Read 


HIRES On: access high-res. pages $C057 49239 -16297 t+ 
Off: use RAMRD, RAMWRT ~~ $C056 49238 -16298 + 


Read HIRES switch $C01D 49181 -16355 Read 
ALTZP Auxiliary stack & z.p. $C009 49161 -163873 Write 
Main stack & zero page $008 49160 -16874 Write 
Read ALTZP switch $C016 49174 -16852 Read 


*When 80STORE is on, the PAGE2 switch selects main or auxiliary display memory. 


+ When 80STORE is on, the HIRES switch enables you to use the PAGE2 switch to switch 
between the high-resolution Page-1 area in main memory or auxiliary memory. 


Table 4-8. 48K RAM Transfer Routines 


Name Action Hex Function 

AUXMOVE JSR  $C312 Moves data blocks between main and auxiliary 
48K memory. 

XFER JMP  $C314 Transfers program control between main and 
auxiliary 48K memory. 
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Table 6-5. 1/0 Memory Switches 


Name 


SLOTC3ROM 


SLOTCXROM 


Function 


Slot ROM at $C300 
Internal ROM at $C300 
Read SLOTC3ROM switch 


Slot ROM at $Cx00 
Internal ROM at $Cx00 
Read SLOTCXROM switch 


Table 6-7. 1/O Routine Offsets and Registers Under Pascal 1.1 Protocol 


Addr. 
$Cs0D 


$CsOE 


$CsOF 


$Cs10 


Offset for 


Initialization 
On entry 
On exit 


Read 
On entry 
On exit 


Write 
On entry 
On exit 


Status 
On entry 
On exit 


X Register 


$Cs 
Error code 


$Cs 
Error code 


$Cs 
Error code 


$Cs 
Error code 
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Location 
Hex Decimal 
$COOB 49163 -16373 
$COOA 49162 -16374 
$CO17 49175 -16361 
$C006 49159 -16377 
$C007 49158 -163878 
$C015 49178 -16363 
Y Register A Register 
$80 
(unchanged) (unchanged) 
$s0 
(unchanged) Character read 
$s0 Char. to write 
(unchanged) (unchanged) 
$s0 Request (0 or 1) 
(changed) (unchanged) 


Notes 


Write 
Write 
Read 


Write 
Write 
Read 


Appendix G Using an 80-Column Text Card 


267 


This appendix explains how to use 80-column text cards with high-level 
languages. Information about using 80-column text cards with assembly 
language programs through the Apple Ile Monitor firmware is found in 
Chapter 3 of this manual. The information in this appendix applies to the 
Apple Ie 80-Column Text Card and the Apple Ile Extended 80-Column Text 
Card. 


If you are using Applesoft, ProDOS, or DOS you can choose to leave the 
80-column text card inactive after installing it. You will want to do this 
when running software that does not take advantage of the 80-column 
display capability. 


The startup procedure for displaying 80 columns of text on your Apple Ile 
depends on which operating system you plan to use. Starting up the system 
with Apple II Pascal or CP/M® is very easy; the operating system does it for 
you; the procedures for starting up with ProDOS or DOS 3.8 are slightly 
more complicated, but not difficult. 


Starting Up With Pascal or CP/M 


Refer to the operating system reference 
manual for your version of Apple Pascal for 
more information. 
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Pascal programmers don’t have to activate the text card because Pascal 
does it for them. If you use the Pascal language or the CP/M operating 
system, displaying 80 columns of text is automatic once you've imstalled the 
card. Simply start up your system with any Pascal or CP/M startup disk. 


CP/M: CP/M (Control Program for Microprocessors) is a trademark of 
Digital Research. To use the CP/M operating system with your Apple Ile, 
make sure the SOFTCARD® by Microsoft or the Z-Engine™ by Advanced 
Logic Systems is correctly installed before you start up the computer. 


Co-Processor Cards and Interrupts: Some co-processor cards that 
were designed for use in the Apple II Plus may not work with an Apple Ile 
without some modification. There could be problems if you want to use 
interrupts on the Apple Ile. If you are having problems with a coprocessor 
card, check with the card’s manufacturer for their recommendations. 


When using Apple II Pascal 1.1, you'll probably want to run the program 
SETUP to make the (+] and (4] keys functional. SETUP is a 
self-documenting program on the Pascal disk APPLES. Pascal ver sions 1.2 
and later are already configured to use the (+] and (4) keys. 
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Starting Up With ProDOS or DOS 3.3 

SSS inj 
ProDOS and DOS 3.8 both look for a startup program on the startup (boot) 
disk as soon as the operating system has been loaded and begins executing. 
If the operating system finds the program, called STARTUP on a ProDOS 
disk and usually called HELLO on a DOS 3.3 disk, it will execute the 
program. 


You can write a customized startup program that will set up the 80-column 
text card in any state you need. Just be sure it is on your startup disk and 
has the startup filename. 


Here is a sample Applesoft startup program that works with both ProDOS 
and DOS 3.8: 


186 HOME: D$=CHR$(C4) 
26 PRINT D$;"PR#3" 
38 END 


You can do whatever you wish with the program from line 20 on. Note that 
the screen will have switched to 80-column text mode after line 20. 


By the Way: If you arrange to have the card active automatically, you 
will still, of course, be able to switch into 40-column mode. 


Using the GET Command 

Sn RR a wh a a a | 
The presence of an active 80-column text card in the Ile requires that 
BASIC programmers use some alternate to Applesoft’s INPUT command if 
their programs are to be userproof. Applesoft programmers should use 
either the GET command or the RDKEY or GETLN subroutines. 


This is because the escape sequences used to switch back and forth 
between modes or to deactivate the card sometimes make it necessary to 
accept escape sequences in INPUT mode when using an 80-column card. 
Because the program accepts escape sequences typed from the keyboard, 
your program will not be userproof against accidental sequences typed in 
response to an INPUT command. 


To get around this problem, you can use the GET command instead. The 
program does not read escape sequences typed from the keyboard in 
response to a GET command. This means that your users can err in their 
responses without endangering the display. 
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When to Switch Modes Versus When to Deactivate 


When using BASIC, deactivate the text card whenever a previous (BASIC) 
program has left the card active (leaving a solid cursor on the screen) or 
whenever you want to send output to a peripheral device. 


Switch back and forth between 40-column and 80-column displays for 
visual appeal. For full use of the control charaeters described later, your 
card must be active, although it can display in either 40-column or 
80-column mode. 


Original lle Tabbing in Applesoft: You must switch to a 40-column display to use 
Applesoft comma tabbing or the HTAB command. 


Display Features With the Text Card 

ee a hee en 
With an active 80-column card you can issue BASIC and PRODOS 
commands in lowercase characters. You can also issue commands in 
lowercase from the keyboard, that is, in immediate mode. This is 
particularly convenient because REM statements and data within quotes 
remain in lowercase as they were typed. 


If you are using DOS 3.3, you must issue commands in uppercase: whether 
or not your card is active. 


INVERSE, FLASH, NORMAL, HOME 

TTT ka 
There are several commands you can give your computer from A _pplesoft 
BASIC to affect the appearance of text on the screen. All of these features 
are described in the Applesoft BASIC Programmer’s Reference Manual. 


O INVERSE tells the computer to display black characters on a white 
background instead of the normal display of white characters on a black 
background. This command is normally only available for uppercase 
characters, but with an active 80-column text card it is available for 
uppercase and lowercase characters. 

co FLASH causes subsequently printed characters to blink quick ly between 
inverse and normal characters. You can turn off the FLASH command by 
typing the NORMAL command. The FLASH command is normally 
available only with uppercase characters; it is not available at all while 
the card is active. 
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oO NORMAL tells the computer to turn off the INVERSE or FLASH 
command and to display subsequently printed characters normally. It 
works the same way with the card active or inactive. 

oO HOME clears the screen and returns the cursor to the upper-left corner of 
the screen. Both the NORMAL HOME and INVERSE HOME commands 
are available while the card is active, but INVERSE HOME works a little 
differently when the card is active. 


By the Way: The FLASH and INVERSE commands can be used to 
highlight important screen messages within a BASIC program. 


Important! If you are using the FLASH command (which means the 80-column text 
card is inactive) and then type PR#8 to activate the card, the screen 
turns white as the cursor goes to the HOME position. Whatever you type 
appears in black characters on the white screen. If you list or run an 
Applesoft BASIC program, some of the characters will appear as 
MouseText characters. To avoid this, remember to use either the 
NORMAL or INVERSE command before you exit the program. 


Tabbing With the Original Apple lle 


You cannot use conventional 40-column tabbing in BASIC with the original 
model Apple Ile with an 80-column display. You do not have to turn off your 
card, but you must switch out of 80-column mode to use the HTAB 
command or to use comma tabbing. 


When an original Apple Ile is displaying 80-column text, you should use the 
POKE 14038 command for horizontal tabbing in the right half of the screen 
instead of the HTAB command. 


Comma Tabbing With the Original Apple Ile 
SS ec ae ae ee eed 


In BASIC you can use commas in PRINT statements to instruct the 
computer to display all or part of your output in columns. This is known as 
comma tabbing. You can use this method of tabbing as long as the screen is 
displaying 40 columns (that is with the card inactive or after issuing an 
command to switch to 40-column mode). You cannot use this 
method of tabbing with an 80-column display. If you try to do so, characters 
will be placed in memory outside the screen area and may change programs 
or data in memory. 
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HTAB and POKE 1403 


SSS ee eee 

The VTAB (vertical tab) and HTAB (horizontal tab) statements can be used 
to place the cursor at a specific location on the screen before printing 
characters. The largest value you can use with the VTAB statement is 24: 
the largest for HTAB is 255. The VTAB command works just the same in an 
80-column display as it does in a 40-column display. 


On the original Apple Ile, the HTAB command causes the cursor to wrap 
around to the next line after it reaches the 40th column, so you cannot use 
this command to position the cursor in the last 40 columns while the screen 
is displaying 80 columns. 


POKE 1408 is specifically designed to solve this problem. Using the 
POKE 1403 command allows you to tab horizontally across the extra 40 
columns provided by the 80-column text card. 


If you want to tab past column 40 while the card is active and the screen is 
displaying 80 columns, use the following, where n is a number from 0 to 79: 


POKE 1463,N 


When you use the HTAB command, HTAB 1 places the cursor at the 
leftmost position on the screen. When you use the POKE 1408 command, 
POKE 1403,0 places the cursor at the leftmost position on the screen. 


Using Control Characters With the Card 


Using BASIC with an active 80-column text card increases the number of 
functions you can perform with control characters. Originally 
control-character commands were so named because they were given from 
the keyboard by pressing the key in conjunction with another key. 
You can perform the same functions from your programs by using an 
equivalent control-character code. Commands based on these two-key 
combinations are called control-character commands even when they must be 
issued from a program. 
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Control Characters and Their Functions 


ar Sd a een ee) 

Table G-1 lists the control-character commands supported by BASIC with 
an 80-column card. The table includes the corresponding command code, its 
function and whether a given command can be executed from the keyboard 
as well as from a program. 


Table G-1. Control Characters With 80-Column Firmware On 


Control 
Character 


Control-G 


Control-H 


Control-J 


Control-K t 


Control-L ¢ 


Control-M 


Control-N tf 
Control-O t 
Control-Q t 
Control-R t 
Control-S * 


Control-U t¢ 
Control-V t 


Control-W t 


Control-X 


ASCII Apple IIe 


Code Name 
BEL bell 
BS backspace 
LF line feed 
VT clear EOS 
FF home 
and clear 
CR return 
SO normal 
SI inverse 
DC1 40-column 
DC2 ~~ 80-column 
DC3 __ stop-list 
NAK — quit 
SYN _ scroll 
ETB _ scroll-up 
CAN _ disable 
MouseText 
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Action Taken by BASICOUT 
Produces a 1000 Hz tone for 0.1 second. 


Moves cursor position one space to the 
left; from left edge of window, moves to 
right end of line above. 


Moves cursor position down to next line in 
window; scrolls if needed. 


Clears from cursor position to the end of 
the screen. 


Moves cursor position to upper-left corner 
of window and clears window. 


Moves cursor position to left end of next 
line in window; scrolls if needed. 


Sets display format normal. 
Sets display format inverse. 
Sets display to 40-column. 
Sets display to 80-column. 


Stops listing characters on the display 
until another key is pressed. 


Deactivates 80-column video firmware. 


Scrolls the display down one line, leaving 
the cursor in the current position. 


Scrolls the display up one line, leaving the 
cursor in the current position. 


Disable MouseText character display; use 
inverse uppercase. 
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Table G-1—Continued. Control Characters With 80-Column Firmware On 


Control ASCII Apple IIe 
Character Code Name Action Taken by BASICOUT 
Control-Y fT EM home Moves cursor position to upper-left corner 


of window (but doesn’t clear). 


Control-Z ft SUB clearline — Clears the line the cursor position is on. 


Control-[ ESC enable Map inverse uppercase characters to 
MouseText MouseText characters. 
Control-\ tf FS forward Moves cursor position one space to the 
space right; from right edge of window, moves it 
to left end of line below. 

Control-}f GS clearEOL Clears from the current cursor position to 
the end of the line (that is, to the right 
edge of the window). 

Control-_ US up Moves cursor up a line, no scroll. 


* Only works from the keyboard. 


+ Doesn’t work from the keyboard. 


How to Use Control-Character Codes in Programs 


To issue a control-character command from a program, use the ASCII 
decimal code that corresponds to the control-character. (See Table G-1.) 


The following example shows how to use ASCII decimal codes in an 
Applesoft BASIC program. Type 


HOME [7] 

NEW 

18 PRINT CHR$C15): PRINT “MAKE HAY" 

26 PRINT CHR$C194): PRINT “WHILE THE SUN SHINES" 
RUN 


(CHR$ is the Applesoft BASIC command that signifies that a 
control-character function is to be performed. ) 
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See Chapter 3 in this manual for a 
description of control-character functions. 


The ASCII decimal codes for inverse video (Control-O) and normal video 
(Control-N) are 15 and 14. When the PRINT statements in the example are 
executed, the display switches to inverse and prints MAKE HAY, then 
switches back to a normal display and prints WHILE THE SUN SHINES. 


A Word of Caution to Pascal Programmers 
Sa ee eee 
Avoid writing Control-U or Control-Q to the console from a Pascal program. 


Either one puts the system into a state that will cause Pascal to eventually 
crash. 


You can’t send control characters from the keyboard to the 80-column 
firmware when using Pascal. The only exceptions to this rule are Control-M 
(CR) and Control-G (BEL). 


Using Control Characters With the Card 215 


Appendix H 


Programming With the Super Serial Card 


For more information about the installation 
and operation of the SSC, see the Super 
Serial Card manual. 


This appendix briefly describes how to use the Apple II Super Serial Card 
(SSC) from programs, how to find the SSC through software, and the 
commands supported by the SSC. 


The SCC is one of the most common serial interface cards used with the 
Apple Ile, and the Apple IIc’s serial ports operate very much like the Super 
Serial Card. This similarity should make it easier for you to write programs 
for both the Apple Ile and Apple IIc. 


Locating the Card 


The Pascal 1.1 firmware protocol is 
described in Chapter 6. 


Locations $Cs05, $Cs07, $CsOB, and $Cs0C (where s is the number of the 
slot where the SSC is installed) contain the identification bytes for the 
Super Serial Card. The identification byte’s values are 


$Cs05 $38 
$Cs07 $18 
$Cs0B $01 
$Cs0C $31 
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The Super Serial Card has two main operating modes: printer mode and 
communications mode. There is nothing you can do from software to 
change from one mode to the other since they are set by the position of the 
jumper block. 


Note to Software Developers: If you are writing software that depends 
on the SSC being in a given operating mode, make sure that your 
documentation tells the user to set up the SSC in the proper way. 


In printer mode, the SSC is set to send data to a printer, local terrninal, or 
other serial device. In communications mode, the SSC is set to operate with 
a modem. From communications mode, the SSC can enter a speciial mode 
called terminal mode. In terminal mode the Apple Ile acts like an 
unintelligent terminal. 
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Operating Commands 

i a ee eee Sa ee ee a as 
For each of the operating modes, you can control many aspects of data 
transmission such as baud rate, data format, line feed generation, and so 
forth. 


Your program can change these aspects by sending control codes as 
commands to the card. All commands are preceded by a command 
character and followed by a carriage return character ($0D). 


The command character is usually Control-I in printer mode and Control-A 
in communications mode and terminal mode. In the command examples in 
the following sections, Control-I is used unless the command being 
described is available only in communications mode or terminal mode. A 
carriage return character is represented by its ASCII symbol, CR. 


There are three types of command formats: 


o Anumber, represented by n, followed by an uppercase letter with no 
space between the characters (for example, 4D to set data format 4). 

o An uppercase letter by itself (for example, R to reset the SSC). 

Oo An uppercase letter followed by a space and then either E to enable or D 


to disable a feature (for example, L D to disable automatic insertion of 
line feed characters ). 


The allowable range of n is given in each command description that follows. 


The choice of enable or disable is indicated with E/D. The underscore 
character (__) before the E/D in commands that allow enable/disable is to 
remind you that a space is required there. 


The SSC checks only numbers and the first letters of commands and 
options. (All such letters must be uppercase. ) Further letters, which you 
can add to assist your memory, have no effect on the SSC. For example, 
XOFF Enable is the same as X E. The SSC ignores invalid commands. 


important! The spaces in command examples are there for clarity; generally you will 
not use spaces in a command string. Where a space is required in a 
command string, an underscore (__) character will appear in the text as a 
reminder. 
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The Command Character 
SS ae ee ee eee eee) 


The normal command character is Control-I (ASCII $09) in printer mode, or 
Control-A (ASCII $01) in communications mode. If you want to change the 
command character from Control-I to Control-something else, send Control-I 
Control-something else. For example, to change the command character to 
Control-W, send Control-I Control-W. To change back, send Control-W 
Control-I. No return character is required after either of these commands. 


You can send the command character itself through the SSC by sending it 
twice in a row: Control-I Control-I; no return character is required after this 
command. This special command allows you to transmit the command 
character without affecting the operation of the SSC, and without having to 
change to another command character and then back again later. 


Here is how to generate this character in BASIC and Pascal: 


Applesoft BASIC: PRINT CHR$C9);"command" 
Pascal: WRITELN CCHRC9), ‘command’ ); 


Baud Rate, nB 


You can use this command to override the physical settings of switches 
SW1-1 through SW1-4 on the SSC. For example, to change the ba ud rate to 
135, send Control-I 4B CR to the SSC. 


Table H-1. Baud Rate Selections 


n SSC Baud Rate n SSC Baud Rate 
0 use SW1-1 to SW1-4 8 1200 

1 a) 9 1800 

2 15 10 2400 

3 109.92 (110) tH 3600 

4 134.58 (185) 12 4800 

5) 150 13 7200 

6 300 14 9600 

i 600 15 19200 
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Data Format, nD 
ee a eo eS 


You can override the settings of switch SW2-1 with this command. The 
table below shows how many data and stop bits correspond to each value 
of n. For example, Control-I 2D CR makes the SSC transmit each character 
in the form one start bit (always transmitted), six data bits, and one stop 
bit. 


Table H-2. Data Format Selections 


n Data Bits Stop Bits 
0 8 1 

l fi l 

2 6 l 

3 i) l 

4 8 a" 

D i 2 

6 6 2 

7 5 2T 


*1 with Parity options 4 through 7 
+ 1% with Parity options 0 through 3 


Parity, nP 


You can use this command to set the parity that you want to use for data 
transmission and reception. There are five parity options available, 
described in Table H-3. 


Table H-3. Parity Selections 


n Parity to Use 
0,2,40r6 None (default value) 
l Odd parity (odd total number of ones) 


3 Even parity (even total number of ones) 
5 MARK parity (parity bit always 1) 
(i SPACE parity (parity bit always 0) 
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For example, the command string Control-I 1P CR makes the SSC transmit 
and check for odd parity. Odd parity means that the high bit of every 
character is 0 if there is an odd number of 1 bits in that character, or 1 if 
there is an even number of 1 bits in the character, making the total number 
of 1 bits in the character always odd. This is an easy (but not foolproof) way 
to check data for transmission errors. Parity errors are recorded in a status 


byte. 


Set Time Delay, nC, nL, and nF 


Some printers can’t Keep up with the Apple Ile when they are doing certain 
operations. You may need to change default settings on the SSC to give a 
printer the time it needs. 


The nC command overrides the setting of switch SW2-2 on the SSC. That 
switch provides two choices: either no delay or a 250 millisecond delay after 
the SSC sends a carriage return character. 


The nL command allows time after a line feed character for a printer platen 
to turn so the paper is vertically positioned to receive the next line. 


The nF command allows time after a form feed character for the printer 
platen to move the paper form to the top of the next page (typically a longer 
time than a line feed). 


Table H-4. Time Delay Selections 


n Time Delay 

0 none 

] 32 milliseconds 

2 200 milliseconds (1/4 second) 
3 2 seconds 
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Important! 


Consult the user manual for a given printer to find out how much time it 
takes to move its print head and platen so you can determine an appropriate 
set of values for these three delays. The idea is to have at least enough time 
for the printer parts to move the required distance, but not so much time 
that overall printing speed is slowed down drastically. Many printers 
require no delays because they have a buffer built in to keep accepting 
characters even while they are doing form feeds and so on. 


A typical setup for a very slow printer would be Control-I 2C CR, 

Control-I 2L CR, Control-I 3F CR; that is, the SSC waits 250 milliseconds 
after transmitting carriage returns, 250 milliseconds after transmitting line 
feeds, and 2 seconds after transmitting form feed characters. 


Echo Characters to the Screen, E_E/D 


For the Apple Ile, as for most computers, displaying (echoing) a character 
on the video screen during communications is a separate step from 
receiving it from the keyboard, though we tend to think if these as one step, 
as on a typewriter. For example, if you send Control-A E_D CR, the SSC 
does not forward incoming characters to the Apple Ile screen. This can be 
used to hide someone’s password entered at a terminal, or to avoid double 
display of characters. 


This command is used in communications mode only. 


Automatic Carriage Return, C 


—————————— a 

Sending Control-I C CR to the SSC causes it to generate a carriage return 
character (ASCII CR) whenever the column count exceeds the current 
printer line width limit. This command is used in printer mode only. 


Once this option is on, only clearing the high-order bit at location $578+s 
(where s is the slot the SSC is in) can turn this option back off. This 
option is normally off. 
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Automatic Line Feed, L_E/D 


You can use this command to have the SSC automatically generate and 
transmit a line feed character after each carriage return character. This 
overides the setting of switch SW2-5. For example, send Control-] L_E CR 
to your printer to print listings or double-spaced manuscripts for editing. 


Mask Line Feed In, M_E/D 


If you send Control-I M_E CR to the SSC, it will ignore any incoming line 
feed character that immediately follows a carriage return character. 


Reset Card, R 


Sending Control-I R CR to the SSC has the same effect as sending a PR#0 
and an IN#0 to a BASIC program and then resetting the SSC. This 
command cancels all previous commands to the SSC and puts the physical 
switch settings back into force. 


Specify Screen Slot, S 
Sa ee ee ree ea 


In communications mode, you can specify the slot number of the device 
where you want text or listings displayed with this command. (Normally 
this is slot 0, the Apple Ile video screen.) This allows chaining of the SSC to 
another card slot, such as an 80-column text card. For the firmware in the 
SSC to pass on information to the firmware in the other card, the other card 
must have an output entry point within its $Cs00 space; this is thre case for 
all currently available 80-column cards for the Apple Ile. 


For example, let’s say you have the SSC in slot 2 with a remote terminal 
connected to it, and an 80-column card in slot 3. Send Control-A 3S CR to 
cause the data from the remote terminal to be chained through the card in 
slot 3, so that it is displayed on the Apple Ile in 80-column format. (Not 
available in Pascal.) 


Translate Lowercase Characters, nT 
a aaa ea Rs ie ie eer eee 


The Apple IIe Monitor translates all incoming lowercase characters into 
uppercase ones before sending them to the video screen or to a BASIC 
program. The nT command has four options, which are shown in Table H-5. 
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Important! 


Table H-5. Lowercase Character Display Options 


es er 


n Action 


0 Change all lowercase characters to uppercase ones before passing 
them to a BASIC program or to the video screen. This is the way the 
Apple Ile monitor handles lowercase. 


l Pass along all lowercase characters unchanged. The appearance of 
the lowercase characters on the Apple II screen is undefined 
(garbage). 

2 Display lowercase characters as uppercase inverse characters (that 


is, as black characters on a white background). 


3 Pass lowercase characters to programs unchanged, but display 
lowercase as uppercase, and uppercase as inverse uppercase (that is, 
as black characters on a white background). 


Suppress Control Characters, Z 


Bane Sane eee es rs) 

If you issue the Z command described here, all further commands are 
ignored; this is useful if the data you are transmitting, such as graphics 
data, contains bit patterns that the SSC can mistake for control characters. 


Sending Control-I Z CR to the SSC prevents it from recognizing any further 
control characters (and hence commands ) whether coming from the 
keyboard or contained in a stream of characters sent to the SSC. 


The only way to reinstate command recognition after the Z command is 
to either reinitialize the SSC, or clear the high-order bit at location 
$5F8+s (where s is the number of the slot in which the SSC is installed). 


Find Keyboard, F_E/ D 


Eee Ee ee eee eee ee 
You can use this command to make the SSC ignore keyboard input. 


For example, you can include Control-I F_D CR in a program, followed by a 
routine that retrieves data through the SSC, followed by Control-I F_E CR 
to turn the keyboard back on. 
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Caution 


XOFF Recognition, X_E/D 


a ee eine 

Sending Control-I X__E CR to the SSC causes it to look for any XOFF ($18) 
character coming from a device attached to the SSC, and to respond to it by 
halting transmission of characters until the SSC receives an XON ($11) 
from the device, signalling the SCC to continue transmission. In printer 
mode, this function is normally turned off. 


In printer mode, full duplex communication may not work with XOFF 
recognition turned on, so be careful. 


Tab in BASIC, T E/D 


—SEE—E———— 

In printer mode only, if you send Control-I T_E CR to the SSC, the BASIC 
horizontal position counter is left equal to the column count. All tabs work, 
including back-tabs. Tabs beyond column 40 require a POKE to location 36. 
Commas only work as far as column 40, and BASIC programs wil] be listed 
in 40-column format. 


Note that this use of tabbing is specific to the SSC—it doesn’t go through 
the 80-column firmware. 


Terminal Mode 
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From communications mode, the SSC can enter terminal mode and make 
the Apple Ile act like an unintelligent terminal. This is useful for connecting 
the Apple Ile to a computer timesharing service, or for conversing with 
another Apple II. 


Entering Terminal Mode, T 
SSS ee ee ee 


Send Control-A T CR to enter terminal mode. This causes the Apple Ile to 
function as a full-duplex unintelligent terminal. You can use this command 
together with the Echo command to simulate the half-duplex terrninal mode 
of the old Apple I] Communications Card. 


By the Way: If you enter terminal mode and don’t see what you type 
echoed on the Apple video screen, probably the modem link has not yet 
been established, or you need to use the Echo Enable command 
(Control-A K_E CR). 
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Transmitting a Break, B 


Sending Control-A B CR causes the SSC to transmit a 233-millisecond break 
signal, recognized by most time-sharing systems as a signoff. 


Special Characters, S_E/D 
rae ee ee ae 


If you send Control-A S__D CR, the SSC will treat the key like any 
other key. 


Quitting Terminal Mode, Q 
SS ee ee ee eee ee 
Send Control-A Q CR to the SSC to exit from terminal mode. 


SSC Error Codes 


eee eee ee ETT a ee et ee 


The SSC uses I/O scratchpad address $678+s (s is the number of the slot 
that the SSC is in) to record status after a read operation. The firmware 
calls this byte STSBYT E. Table H-6 lists the bit definitions of this byte. 


Table H-6. STSBYTE Bit Definitions 


Bit “1” Means “0” Means 

0 Parity Error occurred. No Parity Error occurred. 

| Framing Error occurred. No Framing Error occurred. 
2 Overrun occurred. No Overrun occurred. 

3 Carrier lost. Carrier present. 

D Error occurred. No error occurred. 


The terms Parity, Framing Error, and Overrun are defined in the 
glossary. 


Bits 0, 1, and 2 are the same as the corresponding three bits of the ACIA 
Status Register of the SSC. Bit 3 indicates whether or not the Data Carrier 
Detect (DCD) signal went false at any time during the receive operation. 
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Bit 5 is set if any of the other bits are set, as an overall error indicator. If 
bit 5 is the only bit set, an unrecognized command was detected. If all bits 
are (), no error occurred. 


These error codes begin with the number 32 to avoid conflicting with 
previously defined and documented system error codes. 


In BASIC, you can check this status byte via a PEEK $678+s (s is the SSC 
slot), and reset it with a POKE command at the same location. 


In Pascal, the IORESULT function returns the error code value. 


By the Way: Any character—including the carriage return at the end of 
a WRITELN staterment—will cause posting of a new value in JORESULT. 


Table H-7 shows the possible combinations of error bits corresponding to 
these decimal error codes. 


Table H-7. Error Codes and Bits 


Error Carrier Framing Parity 
Code* Lost Overrun Error Error 
0 no error 

32 illegal command 

33 no no no yes 
34 no no yes no 

30 no no yes yes 
36 no yes no no 

3 no yes no yes 
38 no yes yes no 

39 no yes yes yes 
40) yes no no no 

4] yes no no yes 
42 yes no yes no 

43 yes no yes yes 
44 yes yes no no 

45 yes yes no yes 
46 yes yes yes no 

47 yes yes yes yes 


* Result of PEEK $678+s in BASIC or IORESULT in Pascal. 
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The ACIA 
a ea Na I a ee ae ae em Ne hcp rg ee ey 
The Asynchronous Communication Interface Adapter (ACIA) chip is the 
heart of the Super Serial Card. It takes the 1.8482 MHz signal generated by 
the crystal oscillator on the SSC and divides it down to one of the fifteen 
baud rates that it supports. The ACIA also handles all incoming and 
outgoing signals of the RS232-C serial protocol that the ACIA supports. 


The ACIA registers control hardware handshaking and select the baud rate, 
data format, and parity. The ACIA also performs parallel to serial and serial 
to parallel data conversion, and buffers data transfers. 


SSC Firmware Memory Use 


Table H-8 is an overall map of the locations that the SSC uses, both in the 
Apple Ile and in the SSC’s own firmware address space. 


Table H-8. Memory Use Map 


Address Name of Area Contents 
$0000-$00FF Page zero Monitor pointers, I/O hooks, and temporary 
storage. 


$04xx-$07xx Peripheral slot Locations (8 per slot) in Apple Ile pages $04 
(selected Scratchpad RAM _ through $07. SSC uses all 8 of them. 


locations) 
$C0(8+s)0- Peripheral card I/O Locations (16 per slot) for general I/0; SSC 
$CO(8+s)F — space uses 6 bytes. 


$Cs00-$CsFF Peripheral card One 256-byte page reserved for card in slot s; 
ROM space first page of SSC firmware. 


$C800-$CFFF Expansion ROM Eight 256-byte pages reserved for 2K ROM or 
PROM; SSC maps its firmware onto 
$C800-$CEFF. 
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Zero-Page Locations 
SS eed 


The SSC uses the zero-page locations described in Table H-9. 


Table H-9. Zero-Page Locations Used by the SSC 


Address Name Description 

$24 * CH Monitor pointer to current position of cursor on 
screen 

$26 SLOTI6 Usually (slot x 16); that is, $s0 

$27 CHARACTER. Input or output character 

$28 * BASL Monitor pointer to current screen line 

$2A ZPTMP1 Temporary storage (various uses) 

$2B ZPTMP2 Temporary storage (various uses) 

$35 ZPTEMP Temporary storage (various uses) 

$36 * CSWL BASIC output hook (not for Pascal) 

$37 * CSWH High byte of CSW 

$38 * KSWL BASIC input hook (not for Pascal) 

$39 * KSWH High byte of KSW 

$4E * RNDL Random number location, updated when looking for 


a keypress (not used when initialized by Pascal) 


* Not used when Pascal initializes SSC. 


Peripheral Card !/O Space 
| Se ee as en ea) 


There are 16 bytes of I/O space allocated to each slot in the Apple Ile. Each 
set begins at address $C080 + (slot x 16); for example, if the SSC is in slot 3, 
its group of bytes extends from $C0B0 to $COBF. Table H-10 inter prets the 6 
bytes the SSC uses. 
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Table H-10. Address Register Bits Interpretation 


Address Register Bits Interpretation 


$C081+s0 DIPSW1 0 


(SWL-x) 1 

4.7 

$C082+s0DIPSW2 0 

(SW2-x) 13 

5,7 

$C088+s0TDREG 0-7 

RDREG —O-7 
$(089+s0 STATUS 

0 

1 

9 

3 

4 

5 

6 

7 
$C08A+s0COMMAND 

0 

1 

9.3 

4 

5-7 
$C08B+s0CONTROL 

0-3 

4 

5-6 

7 


SSC Firmware Memory Use 


SW1-6 is OFF when 1, ON when 0 
SW1-5 is OFF when 1, ON when 0 
Same as above for SW1-4 through SW1-1 


Clear To Send (CTS) is true when 0 
Same as above for SW2-5 through SW2-3 
Same as above for SW2-2 and SW2-1 


ACIA transmit register (write) 
ACIA receive register (read) 


ACIA status /reset register 

Parity error detected when 1 

Framing error detected when 1 
Overrun detected when 1 

ACIA receive register full when 1 

ACIA transmit register empty when 1 
Data Carrier Detect (DCD) true when 0 
Data Set Ready (DSR) true when 0 
Interrupt (IRQ) has occurred when 1 


ACIA command register (read/write) 

Data Terminal Ready (DTR): enable (1) 

or disable (0) receiver and all interrupts 

When 1, allow STATUS bit 8 to cause interrupt 
Control transmit interrupt, Request To Send (RTS) 
level, and transmitter 

When 0, normal mode for receiver; when 1, echo 
mode (but bits 2 and 8 must be 0) 

Control parity 


ACIA control register (read/write) 

Baud rate: $00 = 16 times external clock; See 
Table H-1. 

When 1, use baud rate generator; when 0, use 
external clock (not supported) 

Number of data bits: 8 (bit 5 and 6 = 0)7 (5 = 1, 

6 = 0), 6 (5 = 0, 6 = 1) or 5 (bit 5 and 6 both = 1) 
Number of stop bits: 1 if bit 7 = 0; 

if bit 7 = 1, then 1-1/2 (with 5 data bits, no parity), 
1 (8 data plus parity), or 2 
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Scratchpad RAM Locations 


The SSC uses the scratchpad RAM locations listed in Table H-11. 


Table H-11. Scratchpad RAM Locations Used by the SSC 


Address 
$0478+s 


$04F8+5 
$0578+s 


$05F8+s 


$0678+s 
$06F8+s 


$0778+s 


$O7F8+s 


Field name 


DELAYFLG 


PARAMETE 
STATEFLG 


CMDBYTE 


STSBYTE 
CHNBYTE 


PWDBYTE 


BUFBYTE 


COLBYTE 


MISCFLG 


Bit 


—~ 


NS 


o~ 
a~ 


~“ oO 


Interpretation 


Form feed delay selection 

Line feed delay selection 
Carriage return delay selection 
Translate option 


Accumulator for firmware’s command processor 


Command mode when not 0 

Slot to chain to (communications mode) 

Set to 1 after lowercase input character 

Terminal mode when 1 (communications mode) 
Enable CR generation when 1 (printer mode) 
Printer mode default is Control-I; communications 
mode default is Control-A 

Set to 1 to Zap control commands 


Status and IORESULT byte 


Current screen slot (communication mode); when 
slot = 0, chaining is enabled. 

$Cs00 space entry point (communications mode) 
Current printer width; for listing compensation, 
auto-CR (printer mode) 


One-byte input buffer (communications mode); 
used in conjunction with XOFF recognition 

Set to 1 when buffer full (communications mode) 
Current-column counter for tabbing and so forth 
(printer mode) 

Generate line feed after CR when 1 

Printer mode when 0; comminications mode when 1 
Keyboard input enabled when 1 

Control-S (XOFF), Control-R, and Control-T input 
checking when 1 

Pascal operating system when 1; BASIC when 0 
Discard line feed input when 1 

Enable lowercase and special character generation 
when 1 (communications mode) 

Tabbing option on when 1 (printer mode) 

Echo output to Apple Ile screen when 1 
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Appendix | Monitor ROM Listing 


00: 0000 


0000 
0000: 
0000: 0001 
0000: 0000 
S 
S) 
S) 
S 
0000: 
0000: F800 
0000: C100 
0000: C300 
0000: c800 
0000 
0000 
0000: 
0000 
0000 
0000 
0000 
0000: 
0000: 
0000 
0000 
0000 
0000: 
0000: 
0000: 
0000: 0006 
0000 
0000 
0000: 
0000: co00 
0000: C000 
0000: cool 
0000: c002 
0000: C003 
0000: C004 
0000: C005 
0000: C006 
0000: C007 
0000: c008 
0000: C009 
0000: COOA 
0000: COOB 
0000: COOC 
0000: CcOOD 
0000: COOE 
0000: COOF 
0000: C010 
0000: c011 
0000: C012 
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1] TEST 


EQU 0 


LST 
MSB 


IROTEST EQU 


F8ORG 
C1ORG 
C30RG 
C80RG 


F8ORG 
C1ORG 
C30RG 
C80RG 


* 


DO 

EQU 
EQU 
EQU 
EQU 


ON 
ON 

1 
TEST 
$1800 
$2100 
$2300 
$2800 


ELSE 


EQU 
EQU 
EQU 
EQU 
FIN 
MSB 


$F800 
$c100 
$c300 
$c800 


ON 


:REAL VERSION 


;DO LISTING AND SYMBOL TABLES 
;SET THEM HIBITS 


INCLUDE EQUATES 
KHKKKKKKKKKEKRKEKEREKEKEEEKEREREREK AKA KRK KK 


* Apple //e Video Firmware 
x 


RICK AURICCHIO 08/81 
E. BEERNINK, R. WILLIAMS 1984 


ALL RIGHTS RESERVED 


# 
x 
* 
* (C) 1981,1984 APPLE COMPUTER INC. 
* 
* 


KRREEKEKKEKEREKREKEREKREREKERKKKRERKKRRRRKKEK 


* 


GOODF8 EQU 6 
* 


* HARDWARE EQUATES: 


k 
KBD 


EQU 


$c000 


CLR80COL EQU $C000 
SET80COL EQU $CO01 


RDMAINRAM EQU $C002 
RDCARDRAM FQU $C003 
WRMAINRAM EQU $CO004 
WRCARDRAM EQU $CO0O5 


-F8 ROM VERSION 


;Read keyboard 

;Disable 80 column store 
;Enable 80 column store 
;Read from main RAM 
;Read from auxiliary RAM 
;sWrite to main RAM 
;Write to auxiliary RAM 


SETSLOTCXROM EQU $C0O06 ;Switch in slot CX00 ROM 


SETINTCXROM EQU $CO07 


SETSTDZP EQU $C008 
SETALTZP EQU $C009 


SETINTC3ROM EQU SCOOA 


;Switch in internal CX0O0O ROM 
;Switch in main stack/zp/lang.card 
;Switch in aux stack/zp/lang.card 
;Switch in internal $C3 ROM 


SETSLOTC3ROM EQU SCOOB ;Switch in slot $C3 space 
CLR80VID EQU $COOC 


SET80VID EQU $COOD 
CLRALTCHAR EQU $COOE 
SETALTCHAR EQU $COOF 


KBDSTRB EQU $C010 
RDLCBNK2 EQU $C011 
RDLCRAM EQU $CO12 


;Disable 80 column video 
;Enable 80 column video 
;Normal Apple II char set 
;Norm/inv LC, no flash 
;Clear keyboard strobe 
32127 if LC BANK2 in use 
32127 1£ LC is read enabled 
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c013 
CO1lS4 
c015 
C016 
C017 
C0138 
c019 
COLA 
CO1C 
COlLE 
CO1F 
c03 0 
C05 4 
C055 
C05 D 
C05 F 
C06 1 
C06 2 
C08 1 
C08 3 
C08 B 


FBBR3 
FD1 B 
FDF0O 
FF6-9 


0000 
0001 


0020 
0001 
0001 
0001 
0001 
0001 
0001 
0002 
00Q@2 
0029 
0002 
OO2B 


OO2F 
0001 
0002 
0001 
0001 
0001 
0001 


RDRAMRD EQU $C013 3>127 if main RAM read enabled 


RDRAMWRT EQU $C014 3>127 if main RAM write enabled 
RDCXROM EQU SCO15 ;>127 if ROM CX space enabled 
RDALTZP EQU $C016 32127 if alt. zp & le enabled 
RDC3ROM EQU $CO17 3>127 if slot C3 space enabled 
RD80COL EQU $C018 32127 if 80 column store enabled 
RDVBLBAR EQU $C019 3>127 if mot vertical blanking 
RDTEXT EQU SCO1A ;>127 if text mode 

RDPAGE2 EQU $COI1C 32127 if page 2 

ALTCHARSET EQU SCOI1LE 3>127 if alt char set switched in 
RD8O0VID EQU SCOIF 32127 if 80 column video enabled 
SPKR EQU $C030 ;toggle speaker 

TXTPAGE] EQU $C054 ;switches in text page l 
TXTPAGE2 EQU $CO55 ;switches in text page 2 

CLRAN2 EQU SCO5D sannunciator 2 

CLRAN3 EQU  SCOSF sannunciator 3 

BUTNO EQU $C061 ;open-apple key 

BUTNI EQU $C062 ;closed-apple key 

ROMIN EQU §$C081 sswap in DOOO-FFFF ROM 

LCBANK2 EQU $C083 ;swap in LC bank 2 

LCBANK] EQU SCO8B ;swap in LC bank 1 

* 

* MONITOR EQUATES: 


k 

F8VERSION EQU F80RG+$3B3 ;F8 ROM ID 

KEYIN EQU  F8ORG+$51B ;normal input 

COUTL  EQU F80ORG+S5FO ;normal output 

MONZ EQU F8ORG+$769 ;monitor entry point 
* 


* ZEROPAGE EQUATES: 


# 
LOCO EQU 0O sused for doing PR# 
LOC] EQU 1 sused for doing PR# 

DSECT 

ORG $20 
WNDLFT DS l :scrolling window left 
WNDWDTH DS l ;scrolling window width 
WNDTOP DS l ;scrolling window top 
WNDBIM DS l ;scrolling window bottom+tl 
CH DS l ;cursor horizontal 
CV DS l scursor vertical 

DS 2 ;GBASL ,GBASH 
BASL DS Z ;points to current line of text 
BASH EQU BASLtl 
BAS2L DS 2 ;pointer used for scroll 
BAS2H EQU BAS2L+1 
k 

ORG $2F 
LENGTH DS l ;length for mnemonics 

DS 2 
INVFLG DS l 3>127=normal, <127=inverse 
PROMPT DS l sused by monitor upshift 
YSAV DS 1 ;input buffer index for mini 
SAVY 1 DS l ;for restoring Y 
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0036 0002 
0038 0037 
0038 0002 
003A 0039 
003C 003C 
003C 0002 
003E 003D 
003E 0002 
0040 003F 
0040 0002 
0042 0002 
0044 0043 
0044 0001 
OO4E OO4E 
O04E 0002 
0050 OO4F 
0000 

0000: 

0000: 0200 
0000: 

0000 

0000 

0000: 

0000: 

0000: 

0000 

0000: 

0000: 

0000 

0000: 

0000 

0000: 

0000 

0000: 07F8 
0000 

0000 047B 
0000: O4FB 
0000 057B 
0000 O5FB 
0000 067B 
0000 O6FB 
0000 077B 
0000 077B 
0000 O07 FB 
0000 07 FB 
0000: 

0000: 

0000: 

0000: 

0000: 

0000 

0000 

0000 

0000: 
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CSWL 
CSWH 
KSWL 
KSWH 


ALL 
AlH 
A2L 
A2H 


ASL 
A4H 


MACSTAT 


RNDL 
RNDH 


* 
BUF 


EQU 


z 
CSWL+1 
2 
KSWL+1 
$3C 

4 
ALL+1 
2 
A2L+1 
2 

2 
A4SL+1 
1 

S4E 

2 
RNDL+1 


$200 


shook for output routine 


shook for input routine 


;Monitor temps for MOVE 


;A3 NOT USED 


smachine state on breaks 


srandom number seed 


sinput buffer 


* Permanent data in screenholes 


*& 
* 
* 
* 
* 
* 
* 
* 
& 
* 
* 
* 
k 


MSLOT 
& 
OLDCH 
MODE 
OURCH 
OURCV 
CHAR 
XCOORD 
TEMP] 


OLDBASL 


TEMP2 


the firmware. 


EQU 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


OLDBASH EQU 


* 


* 
* 
* 
* 
* 
* 
* 
* 


Oveveeee 
Lesceses 
oDeeeoee 
elesesee 
oe Deccee 


ialocede a 


BASIC MODE 


$7F8 


$478+3 
S4F8+3 
$578+3 
S5F8+3 
$678+3 
S6F8+3 
$778+3 
$778+3 
$7F8+3 
$7 F8+3 


BITS 


Note: these screenholes are only used by 

the 80 column firmware if an 80 column card 

is detected or if the user explicitly activates 
If the 80 column card is not 
present, only MODE is trashed on RESET. 


The success of these routines rely on the 
fact that if 80 column store is on (as it 
normally is during 80 column operation), that 
text page 1 is switched in. 
video firmware if video page 2 is switched in!! 


Do not call the 


3=$Cn ;n=slot using $C800 


;LAST CH used by video firmware 
;svideo firmware operating mode 
380 column CH 

380 column CV 

scharacter to be printed/read 
;GOTOXY X-coord (pascal only) 
;temp 

slast BASL (pascal only) 

;temp 

slast BASH (pascal only) 


BASIC active 
Pascal active 


Print control characters 


- Don't print ctrl chars. 
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0040 
002.0 
0010 
0008 
0004 
0002 
0001 


0080 
0010 
0008 
0004 
0002 


FA4&7 
FC74 
FC7A 
F8B/7 


NEXT OBJECT 
C100 
c100 


oo eQeoee 
cocleoee 
coe eQeee 
ecovclece 
coccelee 
eocvcclee 
coe cece 
eocccol. 
eevee eQ 


ere es | 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
OUSE EQU 


| 
rc 
i) 


Zenaran 
PF 
(omy 


Oeeccces 
Lececees 
eOvscees 
eleccoee 
o Deceee 
coleccee 
ceeQeeee 
cocleoes 
cceeDoee 
cooclece 
coeeeQee 
eocceles 
ececee(De 
coccoel. 
eoceee ed 


ere ee | 


a ee a a CC CC i ee ee a ee ee 


M.PASCAL EQ 


M.CURSOR EQU $10 
M.GOXY EQU $08 
M.VMODE EQU $04 
M.PAS1.0 EQU $02 
k 


Print control characters 
Don't print next ctrl char 


Mouse text inactive 
Mouse text active 


$40 

$20 ;Don't print controls 
$10 

$08 ;Temp ctrl disable 
$04 

$02 

$01 


Pascal Mode Bits 


BASIC active 
Pascal active 


Cursor always on 
Cursor always off 


- GOTOXY n/a 


GOTOXY in progress 


- Normal Video 


U 


Inverse Video 

PASCAL 1.1 F/W ACTIVE 
PASCAL 1.0 INTERFACE 
Mouse text inactive 
Mouse text active 


$80 ;Pascal active 
;Don't print cursor 
;GOTOXY LN PROGRESS 
;PASCAL VIDEO MODE 
-PASCAL 1.0 MODE 


* F8 ROM entries 


* 


NEWBREAK EQU F80RG+$247 
IRQUSER EQU F80RG+S$474 
IRQDONE2 EQU F80RG+S$47A 
TSTROM EQU F8ORG+$B7 
INCLUDE BFUNC 
NAME IS REFLIST.O 
ORG C1ORG 


BFUNCPG EQU 


* 
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C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C100: 
C103: 
C103: 
C105: 
C107: 
C108: 
C1OB: 
C1OE: 
C110: 
Clll: 
C113: 
C115: 
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FECS 
FCFO 


C107 


Stack has PHP for status of internal SCNO0O ROM 


Note: If 80 Vid is on and the MODE byte is valid, 
this call will be dispatched to an 80 column routine 
* by B.FUNCO. Otherwise it will be dispatched to a 

* 40 column routine by B-OLDFUNC. In all cases return 
* to the Autostart ROM is done through F.RETURN. 

* 


B.FUNC JMP DISPATCH ;figure out what to do 
ve 
F.CLREOP LDY CH ; ESC F IS CLR TO END OF PAGE 
LDA CV 
CLEOP1] PHA 
JSR VTABZ 
JSR X.CLREOLZ 
LDY #$00 
PLA 
Apc #S00 ;(carry set) 
CMP WNDBIM 
BCC CLEOP1 


FUNCEXIT EQU F8ORG+$6C5 ;RETURN ADDRESS 
MINI EQU F8ORG+$4F0 

* 

* BASIC FUNCTION HOOK: 

x 

* $C100 is called by the patched $F8 ROM. 

* It provides an extension to $F8 routines 
* that do not work in 80 columns. 

* 

* Before jumping here, the $F8 rom disabled 
* slot I/0 and enabled ROM I/O. This makes 
* the entire space from $C100 — SCFFF with the 
* exception of the $C300 page available. 

k 

* On exit slot I/0 is restored if necessary. 
x 

* INPUT: Y=FUNCTION AS FOLLOWS: 

k 

* 1 = KEYIN 

* 2 = Fix escape char 

* 3 = BASCALC 

* 4 = VTAB or VTABZ 

* 5 = HOME 

* 6 = SCROLL 

* 7 = CLREOL 

% 8 = CLREOLZ 

% 9 = RESET 

* A = CLREOP 

* B = RDKEY 

* C = SETWND 

* D = Mini Assembler 

* E = set 40 columns on PR#0/IN#0 
* F = Fix pick for monitor 

k 

* 

st 

k 

x 
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Clil?: 
C119: 
C119: 
C1l1B: 
C11D: 
GILF? 
Ci21: 
Cl23; 
C123: 
Cl25: 
C126: 
C129: 
C12B: 
C12D: 
C12F: 
C131: 
C133: 
C134: 
C135: 
C137: 
C139: 
C13B: 
Cl3Gz 
C13F: 
C141: 
C143: 
C144: 
C146: 
C148: 
C14A: 
Cl4D: 
C14F: 
CL52% 
C152: 
C152: 
C154: 
C156: 
C158: 
C1L5A: 
C15C: 
CL5E: 
C160: 
C160: 
C160: 
C160: 
C162: 
C165: 
C165: 
C165: 
C165: 
C168: 
C168: 
C168: 
C168: 


03 CE 


03 CE 


F4 Cl 


03 CE 


EB CB 


9A CC 


Cl4D 


C107 


C148 


C13F 
C129 


C152 


C14F 


* 
F HOME 


*% 


F.SCROLL LDA 


SCRL1 


SCRL2 


SCRL3 


GVTZ 


GVTZ2 
x 


F.SETWND EQU 


* 


BCS 


LDA 
STA 
LDY 
STY 
BEQ 


PHA 
JSR 
LDA 
STA 
LDA 
STA 
LDY 
DEY 
PLA 
ADC 
CMP 
BCS 
PHA 
JSR 
LDA 
STA 
DEY 
BPL 
BMI 
LDY 
JSR 
LDA 
JMP 


LDA 
STA 
LDA 
STA 
LDA 
STA 
BNE 


GVTZ 


WNDTOP 
CV 
#$00 
CH 
CLEOP1 


WNDTOP 


VTABZ 
BASL 
BAS2L 
BASH 
BAS2H 


WNDWDTH 


#$01 
WNDBTM 
SCRL3 


VTABZ 


(BASL),Y 
(BAS2L),Y 


SCRL2 
SCRL1 
#$00 


X-CLREOLZ 


CV 
VTABZ 


Be 
#40 


WNDWDTH 


#24 
WNDBTM 
#23 

CV 
GVTZ2 


s=>always to VTABZ 


;(ALWAYS TAKEN) 


sset vertical base 


3=>go do vtab, exit 


* Load Y from BAS2L and clear line 


* 


F.CLREOLZ LDY BAS2L 
JMP X.CLREOLZ ;and clear line 


* 


;set up by SF8 ROM 


* 80 column routines begin here 


* 


B.SCROLL JMP SCROLLUP 


* 


;D0 IT FOR CALLER 


* Clear to end of line using Y = OURCH 


* 


B.CLREOL JMP X.GS 


sclear to end of line 
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C1l6B: 
C1l6B: 
Cl6B: 
C1L6B: 
C1l6B: 
Cl6D: 
C170: 
C170: 
C173: 
C176: 
C179: 
Clic: 
C17G: 
C17F: 
C182: 
C184: 
C187: 
C18A: 
C18A: 
C18A: 
C18A: 
C18A: 
C18A: 
C18A: 
C18Cc: 
C18E: 
C190: 
C192: 
C195: 
C197: 
C199: 
C19B: 
C19D: 
C19F: 
C1A0: 
C1A0: 
ClA2% 
ClA4: 
C1lA6: 
C1A9: 
C1A9: 
C1LAB: 
C1AD: 
C1LAE: 
C1B0: 
C1B2: 
C1B4: 
C1B5: 
C1B6: 
C1B6: 
C1B/: 
C1B9: 
C1BC: 
C1BE: 
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CD 


C8 


C18A 


C19D 


C1 A0 


C19D 


C199 


BA CA 


4C 


C20A 


* 


* Clear to end of line using Y = BAS2L 
* which was set up by the $F8 ROM 
* 
B.CLREOLZ LDY BAS2L sget Y 

JMP X.GSEOLZ j;clear to end of line 
x 
B.CLREOP JMP X.VT 
B.SETWND JMP B.SETWNDX 
B.RESET JMP B.RESETX ;MUST BE IN BFUNC PAGE 
B.RDKEY JMP B.RDKEYX 
* 


B.-HOME JSR X.FF 


;CLEAR TO EOS 


;HOME & CLEAR 


LDA OURCH 

STA CH sCOPY CH/CV FOR CALLER 
STA OLDCH ; REMEMBER WHAT WE SET 
JMP VTAB scalc base & return 


rs 

* Complete PR# or IN# call. Quit video firmware 

* if PR#O and it was active (B.QUIT). Complete call 
* if inactive (F.QUIT). 
te 
B 


-QUIT EQU * 
LDY LOCO,X swas it PR#O/IN#0? 


BEQ NOTO s=>no, not slot 0 
CPY #KEYIN swas it IN#0? 
BEQ ISO ;=>yes, update high byte 
JSR QUIT ;quit the firmware 
F.QUIT LDY LOCO,X ;get low byte into Y 
BEQ NOTO snot slot O, firmware inactive 
F8HOOK LDA #<KEYIN- 3;set high byte to $FD 
STA LOC1,X 
NOTO LDA LOC1,X ;restore accumulator 
RTS 
k 
Iso LDA CSWH ;is $C3 in output hook? 
CMP #<BASICIN 
BNE F8HOOK s=>no, set to SFDOC 
JMP C3IN selse set to $C305, exit A=SC3 


F.RDKEY LDY CH ;else do normal 40 cursor 
LDA (BASL),Y grab the character 


AND #S$3F sset screen to flash 

ORA #540 

STA (BASL),Y j;and display it 
F.NOCUR PLA 


RTS sreturn (A=char) 
* 
F.BASCALC TAY srestore Y 

LDA BASL ;restore A 


JSR BASCALC ;calculate base address 
BCC F.RETURN ;BASCALC always returns BCC! 


Appendix I: Monitor ROM Listings 


CIBE: 
C1BE: 
CIC1L: 
Cic3: 
C1C3: 
C1C6: 
C1Cc8: 
C1CB: 
C1CB: 
C1CC: 
CICE: 
C1D0: 
C1D0: 
C1D3: 
C1D6: 
C1D6: 
C1D6: 
C1D6: 
C1D7: 
C1D9: 
C1DB: 
C1DD: 
C1DF: 
ClE2: 
CIE2% 
C1E5: 
ClE6: 
ClE8: 
C1E9: 
ClE9: 
ClE9: 
ClE9: 
C1lEC: 
ClEF: 
C1Fl: 
C1F2: 
C1F2: 
C1F2: 
C1lF2: 
C1F2: 
C1F4: 
C1F6: 
C1F9: 
ClFB: 
C1FD: 
C1FF: 
C201: 
C204: 
C204: 
C204: 
C204: 
C204: 
:A5 
:20 


C205 
C207 


7B 


80 


28 
03 


c8 
C2 


CA 


FC 


05 
CE 


ClF2 


co 
C201 
C201 


CC 


CE 


B.ESCFIX EQU * 


JSR 


UPSHFT 


B.ESCFIX] LDY #4-1 
B.ESCFIX2 EQU * 


CMP 
BNE 
LDA 


ESCIN,Y 
B.ESCFIX3 
ESCOUT,Y 


B.ESCFIX3 EQU * 


DEY 
BPL 
BMI 
* 
F.BOUT JSR 


JMP 
* 


Be ESCFIX2 
F.RETURN 


BOUT 
F.RETURN 


supshift lowercase 
;SCAN FOR A MATCH 


;1S IT? 


3=>NAW 
;sYES, TRANSLATE IT 


;RETURN:CHAR IN AC 


sprint the character 
;AND RETURN 


* Do displaced mnemonic stuff 


* 


MNNDX TXA 
AND 
STA 
LDA 
AND 
JMP 

* 

GOMINI JSR 
TXA 
STA 


RTS 
* 


* Pick an 80 


* 


FIXPICK LDY 
JSR 


* 


#$03 
LENGTH 
BAS2L 
#S8F 
DOMN 


MINI 


YSAV 


OURCH 
PICK 
#$80 


;get old acc 
smake it a length 


sget old Y into A 
;and go to open spaces 
;do mini-—assembler 


;X=0. Set mode to 0, and counter 
sso not CR on new line 


column character for the monitor 


sget 80 column cursor 
;pick the character 
salways pick as normal 
sand return 


* Load CH into Y and clear line 


* 


F.CLREOL EQU * 
XeCLREOL LDY CH 
X.CLREOLZ LDA #$A0 


BIT 
BPL 
BIT 
BMI 
LDA 


;get horizontal position 
;store a normal blank 


ALTCHARSET ;unless alternate char set 


XCLREOL2 
INVFLG 
X.CLREOL2 
#$20 


X.CLREOL2 JMP CLR40 


* 


;and inverse 


suse inverse blank 
sclear to end of line 


* Call VTAB or VTABZ for 40 or 80 columns. Acc (CV) 
* is saved in BASL. 


* 

F.VTABZ TAY 
LDA 
JSR 


BASL 
VTABZ 


;restore Y 
sand A 
sdo VTABZ 
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C20A: 
C20A: 
C20A: 
C20A: 
C20A: 
C20A: 
C20B: 
C20D: 
C210: 
C213: 
C213: 
C213: 
C213: 
C213: 
C214: 
C216: 
C217: 
C219: 
C21A: 
C21C: 
C21D: 
C21F: 
C220: 
C222: 
C222: 
C222: 
C222: 
C224: 
C225: 
C227: 
C228: 
C228: 
C228: 
C228: 
C228: 
C22B: 
C22D: 
C22F: 
C230: 
C231% 
C233: 
C234: 
C237: 
C23A: 
C23B: 
C23C: 
C23C: 
C23C: 
C23C: 
C23E: 
C23F: 
C242: 
C243: 
C243: 
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03 
C5 FE 
C8 FE 


BA 


A5 


9A 


3D 


E2 


C2 


09 


FB 04 


Cl 


44 C2 


C20A 


C210 


C1D0 


C1BE 


C1B6 


C25C 


C204 


C23C 


* 


* EXIT. EITHER EXIT WITH OR WITHOUT 


* ENABLING 

& 

F.RETURN EQU 
PLP 

F.RET2 BMI 
JMP 

F.RET] JMP 

* 


* Do BOUT, E 


I/O SPACE. 


* 


sGET PRIOR 1/0 DISABLE 
F.RETI 3;=>LEAVE IT DISABLED 
FUNCEXIT ;=>EXIT & ENABLE I/0 
FUNCEXIT+3 ;EXIT DISABLED 


SCFIX, BASCALC, and KEYIN immediately 


* to avoid destroying Accumulator. 


*& 


DISPATCH DEY 
BMI 


* First push 


* If any of 
* valid for 


LDA 
AND 
BNE 
TYA 
CLC 
ADC 
PHA 
JSR 
JSR 
PLA 
TAY 
* 


* Now push a 

k 

GETFUNC LDA 
PHA 
LDA 
PHA 

* 


* RTS goes t 


F.BOUT scode 0 = 80 column output 


BeESCFIX ;code 1 = ESCFIX 


F.BASCALC ;code 2 BASCALC 
B.KEYIN ;code 3 = KEYIN 
F.VTABZ scode 4 = VTABZ 

address of generic return routine 


#<F.RETURN ;return to F.RETURN 


#>F .RETURN-1 


5 bits in S$4FB (MODE) is on, then the mode is not 
video firmware. Use old routines. 


MODE sno, is mode valid? 
#M.PASCAL+M.6+M.4+M.2+M.1 
GETFUNC ;=>no, use 40 column routines 
380 column routines in 
;2nd half of table 


#TABLEN 
CSETUP ;set up 80 column cursor 
VTAB ;calc base 


srestore Y 
ddress of routine 
#<BFUNCPG ;stuff routine address 


F.TABLE,Y 


o routine on stack. When the routine 
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C243: 
C243: 
C243: 
:60 
C244: 
C244: 
C244: 
C244; 
C244: 
C244; 
6245: 
C246: 
C247: 
C248: 


C243 


C249: 
C24A: 
C24B: 
C24C: 
C24D: 
C24E: 
C24F: 
C250: 
C250: 
C250: 
C2502 
C2512 
C252: 
G293% 
C254: 
C255: 
C256: 
C257* 
C258: 
C259% 
C25A: 
C25B: 
C25C3 
C25C: 
:2C 1F CO 


C25C 


C25F: 
2:20 74 C8 
:4C OA C2 
C267: 
C267: 
C268: 
C269: 
C26A: 
C26B: 
C26C: 
C26D: 
C26D: 
:C9 FF 
:FO 04 


C261 
C264 


C26E 
C270 


286 


10 06 


273 
274 
275 
276 
277 
278 
279 
280 
C244 281 
282 
283 
284 
285 


DFB 
287 
288 
289 
290 


000C 295 


C25c 310 


C267 312 


314 
315 
316 
317 
318 
319 
320 
321 
22 
323 
324 
C276 325 


* does an RTS, it returns to F.RETURN, which restores 
* the INTCXROM status and returns. 


3 +t + & + 


» TABLE 


RTS 


EOU 
DFB 
DFB 
DFB 
DFB 


Table of routines to call. A1l routines are 
in the $C100 page. These are low bytes only. 


* 


#>F.HOME-1 3;(5) 40 column HOME 

#>F.SCROLL-1 ;(6) 40 column scroll 
#>F.CLREOL-1 ;(7) 40 column clear line 
#>F.CLREOLZ-1 ;(8) 40 column clear with Y set 


#>B.RESET-1 ;(9) 40/80 column reset 


DFB #>F.CLREOP-1 ;(A) 40 column clear end of page 
DFB #>F.RDKEY-1 ;(B) readkey w/flashing checkerboard 
DFB #>F.SETWND-1 ;(C) Set 40 column window 
DFB #>GOMINI-1 ;(D) Mini-assembler 
DFB #>F.QUIT-1 ;(E) quit before IN#0,PR#0 
DFB #>FIXPICK-1 ;(F) fix pick for 80 columns 
DFB #>MNNDX-1 ;(10) calc mnemonic index 
TABLEN EQU *-F.TABLE 
# 
DFB #>B.HOME-1 ;(11) 80 column HOME 
DFB #>B.SCROLL-1 ;(12) 80 column scroll 
DFB #>B.CLREOL-1 ;(13) 80 column clear line 
DFB #>B.CLREOLZ-1 ;(14) 80 column clear with Y set 
DFB #>B.RESET-1 ;(15) 40/80 column reset 
DFB #>B.CLREOP-1 3;(16) 80 columm clear end of page 
DFB #>B.RDKEY-1 ;(17) readkey w/inverse cursor 
DFB #>B.SETWND-1 ;(18) 40/80 column VTAB 
DFB #>GOMINI-1 ;(19) Mini-Assembler 
DFB #>B.QUIT-1 ;(1A) quit before IN#0, PR#O 
DFB_ #>FIXPICK-1 ;(1B) fix pick for 80 columns 
DFB #>MNNDX-1 3;(1C) calc mnemonic index 
x 
B.KEYIN EQU * 
BIT RD80VID 380 columns? 
BPL B.KEYINI ;=>no, flash the cursor 
JSR BIN ;get a keystroke 
GOF.RET JMP F.RETURN ;and return 
# 
B.KEYINI TAY ;preserve A 
TXA ;put X on stack 
PHA 
TYA ;restore A 
PHA ;save char on stack 
PHA sdummy for cursor/char test 
k 
NEW.CUR PLA ;get last cursor 
CMP #SFF swas it checkerboard? 
BEQ NEW.CURI] ;=>yes, get old char 
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C272:A9 FF 326 LDA #SFF sno, get checkerboard 
C274:D0 02 C278 327 BNE NEW.CUR2 ;=>always 

C276:68 328 NEW.CURI1 PLA sget character 
C277:48 329 PHA sinto accumulator 
C278:48 330 NEW.CUR2 PHA ;save for next cursor check 
C279:A4 24 331 LDY CH sget cursor horizontal 
C27B:91 28 332 STA (BASL),Y sand save char/cursor 
C27D: 333 * 

C27D: 334 * Now leave char/cursor for awhile or 

C27D: 335 * until a key is pressed. 

C27D: 336 * 

C27D:E6 4E 337 WAITKEY1 INC RNDL ;bump random seed 
C27F:DO0 OA C28B 338 BNE WAITKEY4 3;=>and check keypress 
C281:A5 4F 339 LDA RNDH sis it time to blink yet? 
C283:E6 4F 340 INC RNDH 

C285:45 4F 341 EOR RNDH 

C287:29 40 342 AND #$40 

C289:DO E2 C26D 343 BNE NEW.CUR s=>yes, blink it 
C28B:AD 00 CO 344 WAITKEY4 LDA KBD ;Ivories been tickled? 
C28E:10 ED C27D 345 BPL WAITKEY1] sno, keep blinking 
C290: 346 * 

C290:68 347 PLA ;pop char/cursor 

C291 :68 348 PLA ;pop character 
C292:A4 24 349 LDY CH ;and display it 
C294:91 28 350 STA (BASL),Y 3;(erase cursor) 
C296:68 351 PLA srestore X 

C297: AA 352 TAX 

C298:AD 00 CO 353 LDA KBD snow retrieve the key 
C29B:8D 10 CO 354 STA KBDSTRB ;clear the strobe 
C29E:30 C4 C264 355 BMI GOF.RET s=>exit always 

C2A0: 356 * 

C2A0: C2A0 357 B.SETWNDX EQU * 

C2A0:20 52 Cl 358 JSR F.SETWND ;set 40 column width 
C2A3:2C 1F CO 359 BIT RD80VID ;80 columns? 

C2A6:10 02 C2AA 360 BPL SKPSHFT 3=>no, width ok 
C2A8:06 21 361 ASL WNDWDTH smake it 80 

C2AA:A5 25 362 SKPSHFT LDA CV 

C2AC:8D FB 05 363 STA OURCV ;update OURCV 

C2AF:60 364 RTS 

C2B0: 365 * 

C2B0: 366 * HANDLE RESET FOR MONITOR: 

C2B0: 367 * 

C2B0: C2B0 368 B.RESETX EQU * 

C2B0:A9 FF 369 LDA #SFF s;DESTROY MODE BYTE 
C2B2:8D FB 04 370 STA MODE 

C2B5:AD 5D CO 371 LDA CLRAN2 ; SETUP 

C2B8:AD 5F CO 372 LDA CLRAN3 ; ANNUNCIATORS 

C2BB: 373 * 

C2BB: 374 * IF THE OPEN APPLE KEY 

C2BB: 375 * (ALIAS PADDLE BUTTONS 0) IS 

C2BB: 376 * DEPRESSED, COLDSTART THE SYSTEM 

C2BB: 377 * AFTER DESTROYING MEMORY: 

C2BB: 378 * 

C2BB:AD 62 CO 379 LDA BUTNI ‘GET BUTTON 1 (SOLID) 
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24C 
: AD 


03 
00 
61 
1A 


BO 
00 
3C 
BF 


3D 


AO 
E16 


3C 
Ol 


Ol 
EF 


C2C3 380 BPL NODIAGS s=>Up, no diags 
C6 381 JMP DIAGS ;=>else go do diagnostics 
co 382 NODIAGS LDA  BUTNO ;GET BUTTON 0 (OPEN) 
C2E2 383 BPL RESETRET ;=>NOT JIVE OR DIAGS 
384 * 
385 * BLAST 2 BYTES OF EACH PAGE, 
386 * INCLUDING THE RESET VECTOR: 
387 * 
388 LDY #$BO ;LET IT PRECESS DOWN 
389 LDA #0 
390 STA AIL 
391 LDA SBF s;START FROM BFXX DOWN 
392 SEC ;FOR SUBTRACT 
C2D1 393 BLAST EQU * 
394 STA AIH 
395 PHA ;Save acc to store 
396 LDA #SA0O sblanks 
397 STA (AI1L),Y 
398 DEY 
399 STA (AIL),Y 
400 PLA srestore acc for counter 
401 SBC #1 ;BACK DOWN TO NEXT PAGE 
402 CMP #1 ;STAY AWAY FROM STACK! 
C2D1 403 BNE BLAST 
404 * 
405 * If there is a ROM card plugged into slot 3, 
406 * don't switch in the internal ROM C3 space. If not, 
407 * only switch them in if there is a RAM card 
408 * in the video slot. 
409 * 
410 * NOTE: The //e powers up with internal $C3 ROM switched 
411 * in. TSTROMCARD switches it out, RESETRET may or may 
412 * not switch it back in. 
413 * 
C2E2 414 RESETRET EQU * 
co 415 STA SETSLOTC3ROM ;swap in slot 3 
CA 416 JSR TSTROMCRD ;ROM or no card plugged in? 
C2ED 417 BNE GORETNI 3=>ROM or no card, leave $C3 slot 
co 418 STA SETINTC3ROM ;card, enable internal ROM 
419 GORETNI RTS 
420 * 


8A 8B 421 ESCIN DFB $88,$95,$8A,S8B 
* 


422 


423 B.eRDKEYX LDY CH sget cursor position 
424 LDA (BASL),Y j;and character 
425 BIT RN80VID 380 columns? 

C2ED 426 BMI GORETNI 3s=>don't display cursor 
427 JMP INVERT selse display cursor, exit 
428 * 

0002 429 ZSPAREC2 FEQU C30RG-* 

0002 430 DS  C30RG-*,0 

000 431 IFNE *-C30RG 
432 FAIL 2,'C300 overflow' 
433 FIN 
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C300: 
C300: 
C300: 
C300: 
C300: 
C300: 
C300: 
C300: 
C300: 
C300: 
C300: 
C300: 
C300: 
:2C 43 CE 


C300 


C303: 
C305: 
C305: 
C305: 
C305: 
C305: 
238 
:90 
C307: 

C307: 

C307: 

C307: 

C307: 

:18 
:B8 
>50 OC C317 
C30B: 
C30B: 
C30B: 
C30B: 
C30B: 
C30B: 
C30B: 
C30B: 
C30B: 
C30C: 
C30D: 
C30D: 
250 


C305 
C306 


C307 
C308 
C309 


C30E 


C30F: 
Hey & 

C311: 

C311: 

C311: 

C311: 

:4C 76 C3 
>4C C3 C3 
C317: 

C317: 

:8D 7B 06 


C310 


C311 
C314 


C317 


306 


C300 
C300 


70 12 ~=C317 


C305 


C307 


01 
88 


4A 


56 


OoOnN HNO SE WH © 


| Ol el el cell oo ool od cee oe oe 
Oo Om nn & WH — CO 


ho DN Bh KH bo HD po 
SNM & WH = 


Ww NO DO 
Oo 


WwW WwW WwW W Ww 
“SDN & WH — 


& Ww 
OO © 


DP ee? ee ee ee 
SOU Ww Nh = 


> 
oO 


49 
50 


Ww 
bp = 


oF 


INCLUDE C3SPACE 
RAKKKKKKKKEKERAERERKEKRERERREAKKEK REE KAKKK AK 


THIS IS THE $C3XX ROM SPACE: 

Note: This page must not be used by any routines 

called by the F8 ROM. When it is referenced, it claims 

the C800 space (kicking out anyone who was using it). 

This also means that peripheral cards cannot use the AUXMOVE 
and XFER routines from their C800 space. 


+ + *& ee te F 


RHEKEKKKEEKERKEKKEKRERERKKREKEREKKERERKKEKE 


CNOO EQU * 
BASICINT EQU * 
BIT SEV sset vflag (init) 
BVS BASICENT ;( ALWAYS TAKEN) 
k 
* BASIC input entry point. After a PR#3, this is the 
* address that is called to input each character. 
k 
BASICIN EQU * 
SEC 
DFB $90 ;BCC OPCODE (NEVER TAKEN) 
k 
* BASIC output entry point. After a PR#3, this is the 
* address that is called to output each character. 
x 


BASICOUT EQU * 


CLC 

CLV ;CLEAR VFLAG (NOT INIT) 

BVC BASICENT ;(ALWAYS TAKEN) 
* 
* Pascal 1.1 Firmware Protocol table: 
* 
* This tables identifies this as an Apple //e 80 column 
* card. It points to the four routines available to 
* programs doing 1/0 using the Pascal 1.1 Firmware 
* Protocol. 
x 

DFB $01 ;GENERIC SIGNATURE BYTE 

DFB $88 ;DEVICE SIGNATURE BYTE 
* 

DFB #>JPINIT  ;PASCAL INIT 

DFB_ #>JPREAD ;PASCAL READ 

DFB #>JPWRITE ;PASCAL WRITE 

DFB #>JPSTAT  ;PASCAL STATUS 
KHKKKKKRKAKKERKRAKERERERER AER ERER AK KEKKRERE 
k 
* 128K SUPPORT ROUTINE ENTRIES: 


& 


JMP MOVE ;MEMORY MOVE ACROSS BANKS 


JMP XFER ; TRANSFER ACROSS BANKS 
KHAAKKAKKKKK KKK KKKKREK AKER ARERR RRR 


* 
BASICENT STA CHAR 
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C31A:98 
C31B:48 
C31C:8A 
C31D:48 
C31E:08 
C31F: 
C31F: 
C31F: 
C31F: 
C31F: 
C31F: 
C31F:AD 
C322:2C 
C325:30 
C327:09 
C329:8D 
C32C: 
C32C: 
C32C:20 
C32F:28 
C330:70 
C332: 
C3322 
Gi32% 
C332: 
C332: 
C332:90 
C334:AA 
C335:10 
C337:20 
C33A:68 
C33B:AA 
C33C :68 
C33D:A8 
C33E:AD 
C341 :6C 
C344: 
C344:4C 
C347:4C 
C34A: 
C34A: 
C34A:20 
C34D:4C 
C350: 
C350:20 
C353:4C 
C356: 
C356:20 
C359:4C 
C35C: 
C35C: AA 
C35D: FO 
C35F:CA 
C360:D0 


08 


07 


C344 


C344 
CD 


06 
00 


+ + eee F 


* 
NOGETLN 


+ + + & 


* 
JC8 


JBASINIT JMP 


* 
JPINIT 


JPREAD 


JPWRITE 


* 
JPSTAT 


clear. 
2) that control characters should not be echoed. 
M.CTL is cleared by BPRINT. 


TYA 
PHA 
TXA 
PHA 
PHP 


; AND Y 
; AND X 


;SAVE CARRY & VFLAG 


If escape mode is allowed, the high bit of MSLOT is 


Set M.CTL to flag that 1) escapes are allowed, and 


LDA 
BIT 
BMI 
ORA 
STA 


EQU 
JSR 
PLP 
BVS 


If a PR#O 


JMP 


EQU 
JSR 
JMP 
EQU 
JSR 
JMP 
EQU 
JSR 
JMP 


TAX 
BEQ 
DEX 
BNE 


MODE 
MSLOT 
NOGETLN 
#M.CTL 
MODE 


SETC8 


JBASINIT 


;else esc enable, ctl disable 
;get MSLOT 
s=>Esc disable, ctl char enable 


; SETUP C8 INDICATOR 
;GET VFLAG (INIT) 
;=>D0O THE INIT 


has been done, input should be transferred 
from the video firmware to KEYIN. 
if the high bit of the mode byte is set. 


This is detected 


JC8 ;=DPoutput , no problem 
;test mode 
JC8 svideo firmware is on 
SETKEYIN ;else set FDIB as input 
;restore registers 

CHAR 

(KSWL) ;go input the character 
C8BASIC ;GET OUT OF CN SPACE 
BASICINIT ;=>GOTO C8 SPACE 

k 

SETC8 sSETUP C8 INDICATOR 
PINIT sXFER TO PASCAL INIT 

k 

SETC8 ;SETUP C8 INDICATOR 
PREAD sXFER TO PASCAL READ 

& 

SETC8 ;SETUP C8 INDICATOR 
PWRITE ;XFER TO PASCAL WRITE 

sis request code = 0? 
PIORDY ;=Pyes, ready for output 
;check for any input 

PSTERR ;=>bad request, return error 
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C362 


C372 
C375 


308 


10 


A2 
8E 


04 


03 


13 


14 


:2C 00 CO 
C365: 
C367: 
C368: 
C369: 
C369: 
C36B: 
C36C: 
C36): 
C36D: 
C36D: 
C36D: 
C36D: 
C36D: 
C36D: 
C36D: 
C36D: 
C36D: 
C36D: 
C36F: 
:AE 
:60 
C376: 
C376: 
C376: 
C376: 
C376: 
C376: 
C376: 
C376: 
C376: 
C376: 
C376: 
C376: 
C376: 
C376: 
C376: 
C377: 
C378: 
C379: 
C37C: 
G37D: 
C380: 
C381: 
C381: 
C381: 
C381: 
C383: 
C386: 
C389: 
C38B: 
C38B: 
C38B: 
C38E: 


co 


co 


C36B 


C376 


BIT KBD ;look for a key 
BPL PNOTRDY 3=>no keystroked 
PIORDY SEC 
RTS 
# 
PSTERR LDX #3 selse flag error 
PNOTRDY CLC 
RTS 
KHKKKKKK KKK KKKKRERERRERKEKRKAKKKKK KK KKKAK KR 
* NAME : SETC8 
* FUNCTION: SETUP IRQ $C800 PROTOCOL 
* INPUT : NONE 
* OUTPUT : NONE 
* VOLATILE: NOTHING 
* CALLS : NOTHING 


KREKEKKKKKEKKEKEKREREEEEKEKRERERERKE KKK 


* 


SETC8 EQU 
LDX 
STX 
LDX 
RTS 


rs 

#<CNOO ;SLOT NUMBER 

MSLOT ;STUFF LT 

SCFFF skick out other $C8 ROMs 


KEREKEKEKREKRERKEREKREEKEKREKRKEKRK RRR KKEK 


NAME 
FUNCTION: 
INPUT 


OUTPUT 
VOLATILE: 


* 
* 
* 
* 
k 
* 
* 
* 
* 
* CALLS 


: MOVE 


PERFORM CROSSBANK MEMORY MOVE 


: Al=SOURCE ADDRESS 

: A2=SOURCE END 

: A4=DESTINATION START 
: CARRY SET=MAIN-->CARD 


CLR=CARD-->MAIN 


: NONE 


NOTHING 


: NOTHING 


RAKEAKKERIKKEKEKRERKEREKEKEEEKKK KKK 


* 
MOVE EQU 


LDA 

PHA 

LDA 

PHA 
* 


* SET FLAGS 

* 
BCC 
STA 
STA 
BCS 

* 

MOVEC2M EQU 
STA 
STA 


;SAVE AC 
; AND Y 


RDRAMRD  ;SAVE STATE OF 
; MEMORY FLAGS 
RDRAMWRT 


FOR CROSSBANK MOVE: 


MOVEC2M  ;=>CARD—->MAIN 
RDMAINRAM ;SET FOR MAIN 
WRCARDRAM ; TO CARD 
MOVESTRT ;=>(ALWAYS TAKEN) 


* 


WRMAINRAM ;SET FOR CARD 
RDCARDRAM ; TO MAIN 
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C391: 
C391: 
C391: 
C393: 
C393: 
C393: 
C395: 
C397: 
C399: 
C39B: 
C39N: 
C39F: 
C3Al: 
C3A3: 
C3A5: 
C3A7: 
C3A9: 
C3AB: 
C3AD: 
C3AD: 
C3AD: 
C3AN: 
C3B0: 
C3B1: 
C3B3: 
C3B6: 
C3B6: 
C3B9: 
C3BA: 
C3BC: 
C3BF: 
C3BF: 
C3CO0: 
C3Cl: 
C302: 
C3C3: 
C3C3: 
C3C3: 
C3C3: 
C3C3: 
C3C3: 
C3C3: 
C3C3: 
C3C3: 
C3G3: 
C3C3: 
C3C3: 
C3C3: 
C3c3: 
c3G3: 
248 
C3C4: 

C3C4: 

C3C4: 


C3C3 


C391 
00 
C393 
3C 
42 
42 
02 C39D 
43 
3C 
3E 
3D 
3F 
3C 
02 C3AB 
3D 
E6 C393 
04 CO 
03 C3B6 
05 CO 
C3B6 
02 CO 
03 C3BF 
03 CO 
C3BF 
C3C3 


162 * 


163 MOVESTRT EQU * 


164 
165 * 


LDY 


#0 ;DUMMY INDEX 


166 MOVELOOP EQU * 


167 

168 

169 

170 

171 

172 NXTAI1 
173 

174 

175 

176 

177 

178 

179 col 
180 * 


LDA 
STA 
INC 
BNE 
INC 
LDA 
CMP 
LDA 
SBC 
INC 
BNE 
INC 
BCC 


(A1IL),Y  3GET A BYTE 
(A4L),Y *MOVE IT 


AlH 
MOVELOOP ;=>MORE TO MOVE 


181 * RESTORE ORIGINAL FLAGS: 


182 * 
183 

184 

185 

186 

187 C03 
188 

189 

190 

191 

192 MOVERET 
193 

194 

195 

196 


STA 
PLA 
BPL 
STA 
EQU 
STA 
PLA 
BPL 
STA 
EQU 
PLA 
TAY 
PLA 
RTS 


WRMAINRAM ;CLEAR FLAG2 

;GET ORIGINAL STATE 
C03 ;=>IT WAS OFF 
WRCARDRAM 
* 


RDMAINRAM ;CLEAR FLAG1 


;GET ORIGINAL STATE 
MOVERET 3=>IT WAS OFF 
RDCARDRAM 
k 

;RESTORE Y 

; AND AC 


197 BRRKERKERKEKKKKREKRERKEKEREKERERERKRKKEKKEREKKE 


198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 


NAME 
FUNCTI 
INPUT 


OUTPUT 
VOLATI 
CALLS 
NOTE 


ee ee Fe Fe HF HF HF HF F 


210 * 
211 XFER 
212 

213 * 


ON: 


> XFER 


TRANSFER CONTROL CROSSBANK 


: S$O3ED=TRANSFER ADDR 
: CARRY SET=XFER TO CARD 


CLR=XFER TO MAIN 


: VFLAG CLR=USE STD ZP/STK 


: NONE 


LE: 


SET=USE ALT ZP/STK 


SO3ED/03EE IN DEST BANK 


: NOTHING 


: ENTERED VIA JMP, NOT JSR 
20Q KRRRKKKRKKKKAKKKKEKEKREKKKEREREEKREA KKK KKK 


EQU 
PHA 


* 


;SAVE AC ON CURRENT STACK 


214 * COPY DESTINATION ADDRESS TO THE 
215 * OTHER BANK SO THAT WE HAVE IT 
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C3C4: 216 * IN CASE WE DO A SWAP: 


C3C4: 217 * 

C3C4:AD ED 03 218 LDA $03ED ;GET XFERADDR LO 

C3C7:48 219 PHA ;SAVE ON CURRENT STACK 
C3C8:AD EE 03 220 LDA SO3EE ;GET XFERADDR HI 

C3CB:48 221 PHA “SAVE IT TOO 

C3CC: 222 % 

C3CC: 223 * SWITCH TO APPROPRIATE BANK: 

C3CC: 224 * 

C3CC:90 08 C3D6 225 BCC XFERC2M *>=>CARD-—>MAIN 

C3CE:8D 03 CO 226 STA RDCARDRAM ;SET FOR RUNNING 

C3D1:8D 05 CO 227 STA WRCARDRAM ; IN CARD RAM 

C3D4:B0 06 C3DC 228 BCS XFERZP 3=> always taken 

C3D6: C3D6 229 XFERC2M EQU * 

C3D6:8D 02 CO 230 STA RDMAINRAM ;SET FOR RUNNING 

C3D9:8D 04 CO 231 STA WRMAINRAM ; IN MAIN RAM 

C3DC: 232 * 

C3DC: C3DC 233 XFERZP EQU * ;SWITCH TO ALT ZP/STK 

C3DC :68 234 PLA ;STUFF XFERADDR 

C3DD:8D EE 03 235 STA SO3EE ; HI AND 

C3E0 :68 236 PLA 

C3E1:8D ED 03 237 STA S$0O3ED ; LO 

C3E4 :68 238 PLA ;RESTORE AC 

C3E5:70 05 C3EC 239 BVS XFERAZP ;=>switch in alternate zp 
C3E7:8D 08 CO 240 STA SETSTDZP j;else force standard zp 
C3EA:50 03 C3EF 241 BVC JMPDEST s=>always perform transfer 
C3EC:8D 09 CO 242 XFERAZP STA SETALTZP ;switch in alternate zp 
C3EF:6C ED 03 243 JMPDEST JMP (S$03ED) ;=>off we go 

C3F2: 244 * 

C3F2: 0002 245 DS C3ORG+SF4-% ,0 spad to interrupt stuff 
C3F4: 246 * 

C3F4: 247 * This is where the interrupt routine returns to. 
C3F4: 248 * At this point the ROM is not necessarily switched in so... 
C3F4: 249 * 

C3F4:8D 81 CO 250 IRQDONE STA _ S$CO081 sread ROM, write RAM 
C3F7:4C 7A FC 251 JMP IRQDONE2 ;and jump to ROM 

C3FA: 252 * 

C3FA: 253 * This is the main entry point for the interrupt 
C3FA: 254 * handler. This switches in the internal ROM and 
C3FA: 255 * jumps to the main part of the interrupt handler 
C3FA: 256 * at $C400. 

C3FA: 257 * 

C3FA:2C 15 CO 258 irq bit rdcxrom ;Test internal or external rom 
C3FD:8D 07 CO 259 sta setintcxrom ;Force in ROM to get to interrupt handler 
C400: 260 * 

C400: 261 * Fall into $C400 which is now switched in!! 
C400: 262 * 

C400: 20 INCLUDE IRQ 

C400: 1 * 

C400: 2 * Here is the main interrupt handler 

C400: 3% 

C400: L KRAKKKKKKEKRKKKKEKKEKEKERERERERKKER ARERR 

C400: C400 5 newirq equ * 

C400 :D8 6 cld ;make no assumptions!! 
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C401: 
C402: 
C404: 
C405: 
C406: 
C407: 
C408: 
C409: 
C40A: 
C40B: 
C40C: 
C40D: 
C40E: 
C40F: 
C410: 
C4ll: 
C414: 
C416: 
C417: 
C417: 
C41A: 
C41D: 
C41F: 
C421: 
C423: 
C426: 
C427: 
C42A: 
C42C: 
C42F: 
C431: 
C434: 
C436: 
C439: 
C43B: 
C43B: 
C43E: 
C440: 
C442: 
C445: 
C447: 
C449: 
C44c: 
C44F: 
C451: 
C452: 
C455: 
C458: 
C459: 
C45C: 
C45E: 
C45F: 
C461: 
C463: 


01 


C46D 


7 sec 
8 bmi 
9 cle 
10 irqintcx pha 
11 pha 
12 pha 
13 txa 
14 tsx 
15 inx 
16 inx 
17 inx 
18 inx 
19 pha 
20 tya 
21 pha 
22 lda 
23 and 
24 tay 
25 * Now test & 
26 lda 
27 and 
28 and 
29 beq 
30 lda 
31 sta 
32 irq2 rol 
33 bit 
34 bpl 
35 sta 
36 ora 
37 irq3 bit 
38 bpl 
39 sta 
40 ora 
41 irq4 equ 
42 irq5 bit 
43 bpl 
44 ora 
45 bit 
46 bpl 
47 eor 
48 irq6 sta 
49 irq/ bit 
50 bpl 
51 tsx 
52 stx 
53 ldx 
54 txs 
55 sta 
56 ora 
57 irqg8 dey 
58 bmi 
59 sta 
60 pla 


;C=1 if internal slot space 
irqintcx 


;Save A on stack instead of $45 
;Make room for rts if needed 


;Save X 


;Get stack pointer for BRK bit 
;Can't do add cause we need C 


sand Y 


$100,x 
#$10 


;Get status for break test 
sA = $10 if break 
;Save it for later 
set the state of the machine. Don't alter Y 


rd80col ;Test for 80 store and page 2 
rdpage2 

#580 ;Make it 0 or $80 

irq2 ;Branch if no change needed 

#$20 ;Set shifted page 2 reset bit 
txtpagel ;Set page l 

A ;Align bit & shift in slotcx bit 
rdramrd ;Are we reading from aux ram? 
irqg3 ;Branch if main ram read 


rdmainram ;Else, switch main in 


#$20 sand record the event 
rdramwrt ;Do the same for ram write 
irq4 
wrmainran 
#$10 
k 
rdlcram ;Determine if language card active 
irq/ 
#S0C ;Sets two bits. Second is redundant 
rdlcbnk2 ;if INC used to restore. 
irq ;Branch if not page 2 of $DO00 
#506 ;Set bits for page 2 
romin ;Enable ROM STA leaves write enable alone 
rdaltzp ;Last..eand very important 
irq8 ;If alternate stack 
;store current stack pointer at $101 
$101 
$100 ;Retreve main stack pointer from $100 
setstdzp 
#$80 ;Mark stack switched 
;Was it a break? 
irq9 
macstat ;Save state of machine 


;Restore registers 
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dll 


C47C:AD 81 
C480:10 07 
C482:8D 09 
C485:AE Ol 
C489:A0 06 
C48B:10 06 
C48D:BE Cl 
C490:FE 00 
C494:30 03 


C497:DO F2 
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FC 


irq9 


tay 
pla 
tax 
pla 


pla ;A stored where RTS address would go 


jmp newbreak 3;Go to normal break routine stuff 


pha ;save state of machine on stack 
lda mslot ;Save mslot 
pha 


lda #<irqdone ;Save return irq address 
pha 


lda #>irqdone ;so when interrupt does RTI 


pha ;[t returns to irqdone 
php ;Status for user's RTI 
jmp irquser ;OffF to the user 


The user's RTI returns here 
BEWARE 


The 


rom must be reenabled with a LDA romin 


This way if the LC was write protected, it still is 


irgdnl 
irqdn2 


irqdn3 


irqdn4 


it was write enabled, it still is 

it was being write enabled ( 2 ldas), it 
restore loop uses an INC because some of 
some are write. It must be an INC abs,x 
65C02 do two reads before the write. 


still will be 
the switches are read 
since both the 6502 amd 


lda 
pla 
bpl 
sta 
ldx 
txs 
ldy 
bpl 
ldx 
inc 
dey 
bmi 
asl 
bne 
asl 
asl 
pla 
tay 
tsx 
lda 
pha 
lda 
pha 
lda 
adc 
pha 
lda 
pha 


romin ;Must be lda! 

;Recover machine state 
irqdnl ;Branch if main ZP 
setaltzp 
$101 ;Get alt stack pointer 
#S06 sY = index into table of switch addresses 
irqdn3 ;Branch if no change 
irqtble,y ;Get soft switch address 
$cO00 ,x ;Hit the switch. NO PAGE CROSS! 
irqdn4 
A sGet next bit to check 
irqdn2 
A ;C = 1 if internal slot space 
A 

;Restore the registers 

;save the stack pointer 
#$40 ;RTL opcode 
#<setslotcxrom 
#>setslotcxrom 
#0 ;Add 1 if internal slot space 
#S8D ;STA setslotcxrom 
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C4AC:9A 114 
C4AD:8A 115 
C4AE:69 03 116 
C4B0:AA 117 
C4B1 :38 118 
C4B2:E9 07 119 
C4B4:9D 00 01 120 
C4B7 :E8 121 
C4B8:A9 Ol 122 
C4BA:9D 00 O01 123 
C4BD:68 124 
C4BE:AA 125 
C4BF:68 126 
C4C0 :60 127 
C4C1:83 8B 8B 129 
C4c4:05 03 55 130 
C4C7: 21 
Sa NEXT OBJECT FILE 
C600 C600 l 
C600 2 
C600 3 
C600 4 
C600: 5 
C600 6 
C600 7 
C600 8 
C600 9 
C600 10 
C600: 11 
C600: 12 
C600 13 
C600 14 
C600: 15 
C600: 16 
C600: 17 
C600: 18 
C600: 19 
C600: 20 
c600: 21 
C600: 22 
C600: 23 
C600: 24 
C600: 25 
c600: 26 
C600 C051 27 
C600: 00009 28 
C600: 0001 29 
C600: O5B8 30 
c600: C0300 31 
C600: 32 
C600 C&00 33 


irqtble 


NAME IS 


eee Fe eH He HEHEHE He He HH He HH HH HSH HH HF HF KH HF F 


TEXT 
IOUIDX 
MMU IDX 
SCREEN 
IOSPACE 
* 


DIAGS 


txs 


txa 


adc 
tax 
sec 
sbc 
sta 
inx 
lda 
sta 
pla 
tax 
pla 
rts 


dfb 
dfb 


;Restore stack pointer 
;Make return address on stack point to code on stack 
3;C = O from earlier adc 


#3 


#7 
$100,x 


;Point to where code starts 


#$1 


$100 ,x 


3;Go to code on stack 


>1lcbank2,>1lcbankl ,>lcbankl 
>wrcardram,>rdcardram,>txtpage2 


INCLUDE DIAGS 
REFLIST.1 


ORG 


C30RG+$300 


These routines test all 64K RAM, as well as the 64K on an Auxiliary 
memory card (when present). 
of the IOU, all combinations of the IOU switches are tested and ver- 
ified. 


With the exception of the INTCXROM switch 


All configurations of the MMU switches are also tested. 


In the event of any failure, 
is written to screen memory indicating the source of the failure. 

When RAM fails the message is composed of "RAM ZP" (indicating failure 
detected in the first page of RAM) or "RAM" (meaning the other 63./75K), 
followed by a binary representation of the failing bits set to 
For example, "RAM 
detected as failing. 
printed preceeding the message. 


equ 
equ 
equ 
equ 
equ 


equ 


the diagnostic is halted. A message 


se ae 
0110 000 0" indicates that bits 5 and 6 were 
To represent auxiliary memory, a "*" symbol is 


When the MMU or IOU fail, the message is simply "MMU" or "IOU". 


The test will run continuously for as long as the Open and Closed 
Apple keys remain depressed (or no keyboard is connected) and no 
failures are encountered. 
the middle of the screen when a successful cycle has been run and 
either of the Apple keys are no longer depressed. Another cycle 

may be initiated by pressing both Apple keys again while this message 
is on the screen. 
without the Apple keys depressed. 


The message "System OK" will appear in 


To exit diagnostics, Control-Reset must be pressed 


$c051 
$09 
$01 
S5B8 
$c000 


*k 
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C600 


C603: 
C605: 
C607: 
C608: 
C6OB: 
C60D: 
C60E: 
C610: 
C611: 
C614: 
C616: 
C618: 
C619: 
COlB: 
C61C: 
COl1F: 
C621: 
C623: 
C624: 
C626: 


C628: 
C62A: 
C62B: 
C62E: 
C62E: 
C630: 
C632: 
C634: 
C636: 
C638: 
C63A: 
C63B: 
C63E: 
C641: 
C643: 
C645: 
C647: 
C649: 
C64C: 
C64F: 
C651: 
C653: 
C655: 
C657: 
C659: 
C65A: 
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78D 
C603: 
C603: 
C603: 
C603: 


50 


CO 


C7 


C607 
C7 
C628 
C610 
co 
C623 


C607 
C62E 


C6 
C62E 


Test Zero-Page, then all of memory. 


Sta 


$C050 


Report errors when encountered. 


* 
* Accumulator can be anything on entry. All registers used, but no sta<k. 
* Addresses between $C000 and SCFFF are mapped to main $DO00 bank. 

* Auxillary 64K is also tested if present. 


TSTZPG 


zpl 


zp2 


zp3 


ZPERROR 


TSTMEM 


meml 
mem2 


men3 
mem4 


ldy 
ldx 
ele 
adc 
sta 
inx 
bne 
cle 
adc 
cmp 
bne 
inx 
bne 
ror 
bit 
bpl 
eor 
dey 
bpl 
bmi 


eor 
cle 
jmp 
equ 
stx 
stx 
stx 
ldx 
stx 
inc 
tay 
sta 
sta 
lda 
and 
cup 
bne 
lda 
lda 
lda 
adc 
bne 
lda 
sta 
tya 
ldy 


#S$4 
#0 


ntbl,y 
$00,x 


zpl 


ntbl,y 
S00 ,x 
ZPERROR 


zp2 

a 
RDVBLBAR 
zp3 

#SA5 


zpl 
TSTMEM 


$00,x 


BADBITS 
* 

$01 

$02 

$03 

#4 

$04 

$01 


$C083 
$C083 
SOl 
#$ FO 
#SCO 
memn3 
SCO8B 
$CO8B 
SOl 
#SF 
mem4 
$01 
$03 


#$00 


;fill zero page with a pattern 


safter all bytes filled, 
; ACC has original value again. 
sso values can be tested 


;branch if memory failed 
sloop until all 256 bytes tested 


;change ACC so location S$FF will change 
; use RDVBLBAR for a little randomness... 


;use a different pattern now 
sbranch to retest with other value 
;branch always 


swhich bits are bad? 
;indicate zero page failure 


-do RAM SLOO-SFFFF five times 
;point to page l first 
ssave ACC in Y for now 


santicipate not $C000 range... 


;Zet page address 
stest for SCO-SCF range 


sbranch if not... 
;select primary $DO000 space 
;Plus carry =+$10 


;branch always taken 


;restore pattern to ACC 
;fill this page with the pattern 
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C65C: 
C65D: 
C660: 
C662: 
C663: 
C665: 
C667: 
C668: 
C66A: 
C66C: 


C66E: 
C670: 
C671: 
C674: 
C677: 
C679: 
C67B: 
C67D: 
C67F: 
C682: 
C684: 
C686: 
C688: 
C68A: 
C68C: 
C68D: 
CO8F: 
C690: 
C693: 
C695: 
C697: 
C699: 
C69A: 
C69C: 
C69E: 
C69F: 
C6Al1: 
C6A3: 
C6A5: 
C6A6: 
C6A9: 
COAB: 
C6OAD: 
CO6AF: 


C6BL: 
C6B2: 
C6B5: 
C6B/7: 
C6BA: 
C6BB: 


C7 


C667 


C65C 


C63A 


co 
co 


C688 
co 


C68A 


C7 


C6CC 


C69E 


C68F 

C670 
co 

C6AD 


C68 


C9 
C6 BE 
OC 


0c 


mem6 


mem/ 


mem8 
mem9 


memA 


memB 


memC 


cle 
ade 
sta 
dex 
bpl 
ldx 
iny 
bne 
inc 
bne 


ine 
tay 
lda 
lda 
lda 
and 
cmp 
bne 
lda 
lda 
adc 
bne 
lda 
sta 
tya 
ldy 
cle 
adc 
eor 
bne 
lda 
dex 
bol 
ldx 
iny 
bne 
inc 
bne 
ror 
bit 
bpl 
eor 
dec 
bpl 


TAX 
JSR 
BNE 
ASL 
ASL 
CMP 


ntbl,x 
($02),y 


mem6 


#4 


mem)S 
l 
mem2 


$01 


$C083 
$C083 
$01 
#SFO 
#SC0O 
mem8 
SCO8B 
$01 
#SF 
mem9 
SOl 
$03 


#$00 


ntbl,x 
($02),y 
MEMERROR 
($02),y 


memB 


#4 


memA 

l 

mem/ 

a 
RDVBLBAR 
memC 
#SA5 

$04 


nenl 


STAUX 
SWCHTST1 
$c00 

A 

$c00 


;keep x in the range 0-4 


s;all 256 filled yet? 

sbranch if not 

sbump page # 

sloop through $0100 to $FFOO 


;point to page 1 again 
;save ACC in Y for now 
santicipate not $C00O0 range... 


;fZet page address 
stest for SCO-SCF range 


sbranch if not... 
;select primary $DO00 space 


;Plus carry =+$10 
;branch always taken 


;restore pattern to ACC 
;fill this page with the pattern 


;if any bits are different, give up!!! 
restore correct pattern 
skeep x in the range 0-4 


sall 256 filled yet? 

sbranch if not 

sbump page # 

;loop through $0100 to $FFOO 

;change ACC for next pass 

; use RDVBLBAR for a little randomness... 


shave 5 passes been done yet? 
sbranch if note.e. 


;Ssave acc 

;set aux memory & write SEE to $C00,$800 
3=>not 128K 

;shift test byte 


;check memory 


Appendix I: Monitor ROM Listings 


315 


COBE: 
C6C0: 
C6C3: 
C6C5: 
C6C6: 
C6C9: 
C6CC: 
C6CD: 
C6CE: 
C6D1: 
C6D2: 
C6D4: 
C6D7: 
C6D9: 
CODB: 
CODE: 
C6EL: 
C6E2: 
C6E3: 
C6E5: 
COE8: 
C6EB: 
C6EE: 
C6F1: 
C6OF4: 
C6F/7: 
COF8: 
C6FA: 
COFB: 
C6FD: 
C6FF: 
C701: 
C7032 
C7055 
C707: 
C70A: 
C70D: 
C710: 
Gfils 
C713: 
C715% 
C716: 
Crl7: 
C718: 
C71A: 
C71B: 
C/71E% 
C71F: 
C720: 
Ci2z2: 
C724; 
C726: 
C729: 
C72B: 
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C736 


C736 


05 


C715 
C722 


C7 
C72E 
C7 


SWCHTST1 BNE SWCHTST 


CMP 
BEQ 
txa 
STA 
jmp 


$800 
SWCHTST 


SETALTZP 
TSTZPG 


MEMERROR sec 


BADBITS 


bbitsl 


clrsts 


clrs 


badmain 


badprim 


bbits2 


hangx 


BADSWICH ldy 


bswtchl 


tax 
lda 
clv 
bpl 
bit 
lda 
ldy 
sta 
sta 
dey 
dey 
bne 
sta 
sta 
sta 
sta 
sta 
sta 
iny 
bne 
txa 
beq 
ldy 
bcs 
ldy 
lda 
bvc 
sta 
lda 
sta 
dey 
bpl 
ldy 
txa 
lsr 
tax 
lda 
rol 
sta 
dey 
dey 
bne 
beq 


lda 
bec 
lda 


RDRAMRD 


bbitsl 
setv 
#5 AO 
#6 


s=>not 128K 
;look for shadowing 
;=>not 128K 


;swap in alt zero page 

; and test it! 

sindicate main ram failure 

;save bit pattern in x for now 
;determine if primary or auxillary RAM 
swith V-FLG 

;branch if primary bank 


;try to clear video screen 


IOSPACE~2 ,y 
LOSPACE+6 , y 


clrsts 
TEXT 
TXTPAGE1 
$400,y 
$500,y 
$600 ,y 
$700,y 


clrs 


BADSWTCH 
#3 
badmain 
#5 

#SAA 
badprim 
screen-8 
rmess,y 


screen—/ ,y 


badprim 
#$10 


a 


#$58 
a 


screen-2,y 


bbits2 
hangx 
#2 
smess,y 
bswtch2 


stest for switch test failure 
;branch if it was a switch 


sbranch if ZP ok 


;mark aux report with an asterisks 


smessage is either "RAM" or "RAM ZP" 
;print bits 


sbits are printed as ascii O or 1 


shang forever and ever 


;branch if MMU in error 


smess+3,y ;else indicate I0U error 
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C72E: 
C731: 
C732: 
C734: 


C736: 
C738: 
C73A: 
C73B: 
C7 3Ei 
C740: 
C742: 
C745: 
C748: 
C749: 
C74B: 
C74B: 
C74E: 
C74F: 
C750: 
C753% 
C755: 
C757: 
C758: 
C75A: 
C75D: 
C75F: 
C761: 
C764: 
C766: 
C768: 
C768: 
C769: 
C76A: 
C7 6B: 
C76D: 
C76F: 
C770: 
C772: 
C774; 
C776: 
C776: 
C778: 
C77A: 
C77D: 
C77F: 
C781: 
C783: 
C785: 
C788: 
C78B: 
C78E: 
C791: 


05 


C726 
C734 


C7 
C74¥F 
C745 

C7 

BF 


C73A 
co 
C7 
C763 
C74B 
C761 
CO 
C776 
C74F 
co 


C7746 
C74F 


C73A 


C77 D 


C738 


C736 


bswtch2 


hangy 


SWCHTST 
swtstl 
swtst2 


swtst3 


& 
click 


swtst4 


swtst5 


* 
swtst6 


swerr 


BIGLOOP 
blp2 


blp3 


sta 
dey 
bpl 
bmi 


ldy 
lda 
ror 
ldx 
beq 
bec 
ldx 
sta 
iny 
bne 


ldx 
rol 
dey 
ldx 
beq 
bmi 
rol 
bec 
asl 
bee 
bes 
asl 
bes 
bee 


rol 
iny 
sec 
sbc 
bcs 
dey 
bne 
ldy 
bne 


ldx 
cpy 
jmp 
lsr 
bne 
lda 
ldy 
sta 
sta 
sta 
sta 
iny 


screen,y 


bswtchl 
hangy 


#MMULDX 
#S7F 


a 


SWTBLO, y 


swtst4 
swtst3 


SWTBLI ,y 


sprint "MMU" or "IOU" 
;branch forever 


sset switches of the LOU/MMU to match Accumulator 


sbranch if done setting switches 
;branch if setting switch to O-state 
;else get index to set switch to l 


IOSPACE-1,x ;set switch 


swtst2 


$C030 
a 


RSWTBL,y 


swtst6 
click 
a 
swtst5 


IOSPACE ,x 


swerr 
swtst4 


IOSPACE,x 


swerr 
swtst4 


#1 
swtst2 


BIGLOOP 
## LOULDX 
swtstl 


#0 


# LOULDX+1 


bbitsl 
$80 
SWCHTST 
#SA0 

#0 
$400,y 
$500,y 
$600,y 
$700,y 


Appendix I: Monitor ROM Listings 


sbranch always taken... 


snow verify the settings just made 
;branch if done this pass 
;branch if this switch no to be verified. 


;branch always 


;branch always 


;restore original value 
> and IOU/MMU index 


;try next pattern 

;was MMU just tested? 

;branch if IOU was just tested 
;else, go test IOU. 


;branch always taken... 


;indicate switch error 
;set carry if IOU was cause 


;clear screen for success message 
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C792:D0 Fl C785 246 bne blp3 


C794:AD 61 CO 247 blp4 LDA $C061 ;test for both Open and Closed Apple 
C797:2D 62 CO 248 AND $C062 3; pressed 

C79A:0A 249 asl a s;put result in carry 

C79B:E6 FF 250 INC SFF 

C79D:A5 FF 251 LDA SFF 

C79F:90 03 C7A4& 252 bee dquit 

C7A1:4C 00 C6 253 jmp DIAGS 

C7A4: 254 * 

C7A4:AD 51 CO 255 dquit lda TEXT ;put success message on the screen 
C7A7:A0 08 256 ldy #8 

C7A9:B9 F6 C7 257 suc2 lda_ success,y 

C7AC:99 B8& 05 258 sta SCREEN,y 

C7AF :88 259 dey 

C7B0:10 F7 C7A9 260 bpl suc2 

C7B2:30 EO C794 261 bmi blp4 ;loop forever 

C7B4: 262 * 

C7BA4: C7B4 263 setv equ * 


C7B4:53 43 2B 29 264 ntbl dfb 83,67,43,41,7 

C7B9:00 89 31 03 265 swtbl0 dfb $00,$89,$31,$03,$05,$09,$0b,$01,$00,$83,$51,$53,$55,$57,S0F, SOD 
c7C9:00 81 31 04 266 swtbll dfb $00,$81,$31,$04,$06,S0A,S$0C,$02,$00,$84,$52 ,$54,$56,$58,$10, SOE 
C7D9:00 11 FF 13 267 rswtbl dfb $00,$11,$FF,$13,$14,$16,$17,$18,$00,$12,$1A,$1B,$1C,$1D,$1E, $1F,$00 
C7EA: 268 MSB ON 

C7EA:D2 Cl CD AO 269 rmess asc "RAM zp" 

C7FO:CD CD D5 C9 270 smess = asc "MMUIOU" 


C7F6:D3 F9 F3 F4 272 success asc "System OK" 


C7FF: C7FF 273 zzzend equ * 

C7FF: 22 INCLUDE C8SPACE 

C7FF: 0001 1 DS C80ORG-*,0 ;pad to C800 

C800: 2 %* 

c800: 3 * This entry point is only used by Pascal 1.0 

c800: 4 % 

C800:4C BO C9 5 JMP PINIT1.0 ;PASCAL 1-0 INIT 

C803: 6 * 

C803: 7 * BASIC initialization: 

C803: 8 * 

C803: 9 * This is called by the $C3 space only after a PR#3 or 
C803: 10 * the equivalent (a JSR $C300). 

C803: ll * 

C803: 12 * It causes a copy of the $F8 ROM to be placed in the 
C803: 13 * language card if the language card is switched in and 
C803: 14 * the ID byte doesn't match. It sets up all the 

C803: 15 * screenhole variables to support its operation. If the 
C803: 16 * 80 column card is detected, it sets things up for 80 column 
C803: 17 * operation, else 40 column operation. Then it clears the 
C803: 18 * screen and prints the character that was in the accumulator 
C803: 19 * upon entry. 

C803: 20 * 

C803: C803 21 BASICINIT EQU * 

C803:20 F4 CE 22 JSR COPYROM ;If LC in, copy F8 to it 

C806:20 2A C8 23 JSR C3HOOKS sout=$C307, in=$C305 

C809:20 2E CD 24 JSR DO40 sset full 40-col window 
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:A9 
:8D 


01 
FB 


04 


C8LE 


C841 


CO 
C83B 
co 


0003 
0000 


24C 50 C3 


LDA #M.MOUSE ;init with mouse text off 
STA MODE ;Set BASIC video mode 
* 


* IS THERE A CARD? 
* 


JSR TESTCARD ;SEE IF CARD PLUGGED IN 
BNE CLEARIT ;=>IT'S 40 
ASL WNDWDTH ;SET 80-COL WINDOW 
STA SET80COL ;ENABLE 80 STORE 
STA SET80VID ; AND 80 VIDEO 
* 


* HOME & CLEAR: 
x 
CLEARIT EQU * 
STA SETALTCHAR ;SET NORM/INV LCASE 
JSR X.FF ;CLEAR IT 
LDY OURCH ;set up cursor for store 
JMP BPRINT ;always print a character 
x 
C3HOOKS LDA #>BASICOUT ;set output hook first 
STA CSWL 
LDA #<CNOO 
STA CSWH 
k 


* C3IN is called by IN#O if CSWH = #S$C3 
* 


C31IN LDA #>BASICIN ;set input hook 


STA KSWL 
LDA #<CNOO 
STA KSWH 
RTS exit with A=$C3 for IN#O stuff 
* 
GETKEY INC’ RNDL ;BUMP RANDOM SEED 
BNE GETK2 
INC RNDH 
GETK2 LDA KBD ;KEY PRESS? 
BPL GETKEY 3=>NOPE 
STA KBDSTRB ;CLEAR STROBE 
RTS 
x 
KAKKKKKK RARER IRE RE RIKER KK BREAKER IA 


*% 


* PASCAL 1.0 INPUT HOOK: 

k 
DS C8ORG+S4D-*,0 ;pad to 1.0 hooks 
IFNE *-C80RG-$4D ;ERR IF WRONG ADDR 
FAIL 2, 'C84D HOOK ALIGNMENT! 
FIN 


JMP JPREAD ;=>GO TO STANDARD READ 
KKEKKEKKKKKKKR AKER RERE KKK EEK REREEREKERA 


x 

* CSETUP compensates for everything that the user 
* can do to change the cursor status: poke CV, CH, 
* OURCH, WNDWDTH. It updates the video firmware's 
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C850: 
C850: 
C850: 
C850: 
C850: 
C852: 
C855: 
C857: 
C85A: 
C85C: 
C85F: 
C861: 
C862: 
C865: 
C867: 
C869: 
C86C: 
C86F: 
C870: 
C870: 
C870: 
C870: 
C870: 
C870: 
C870: 
C870: 
C870: 
C870: 
C870: 
C870: 
C870: 
C872: 
C873: 
C874: 
C874: 
C875: 
C878: 
C879: 
C87A: 
C87B: 
C87C: 
C87C: 
0000: 
C87E: 
C87E: 
C87E: 
C87E: 
C87E: 
C87E: 
C87E: 
C87E: 
C881: 
C884: 
C886: 


320 


35 


FE 


7B 


5E 


05 


04 


05 


05 


05 
05 


06 


C85F 


C86C 


C873 
C874 


C8/C 
C8DC 
0000 


* versions of these values for its own use. 
* COPY USER'S CURSOR IF IT DIFFERS FROM 
* WHAT WE LAST PUT THERE: 
k 
CSETUP LDA CV ;set up OURCV 
STA OURCV 
LDY CH ;GET IT 
CPY OLDCH 31S IT THE SAME? 
BEQ CS2 3=>YES, USE OUR OWN 
STY OURCH ;update our cursor 
CS2 LDA WNDWDTH scursor horizontal must not 
CLC ;be greater than window width 
SBC OURCH 3if it is, then put cursor 
BCS CS3 sat left edge of window 
LDY #0 
STY OURCH 
Gs3 LDY OURCH sexit with Y = CH 
RTS 
k 
* BIN and BOUT are used when characters are 
* input and output by the $F8 ROM while 80VID 
* is on. They cannot use the $C3 entry points 
* because that switches in the $C8 space, causing 
* possible conflict with other $C8 users. 
* These routines are only called by the $C1LOO-SC2FF space. 
* 
* These entry points will only work if the card was 
* first initialized using a PR#3. 80 columns will not 
* work simply by turning on the 80VID flag. 
# 
BOUT LDY SAVY1 sload Y stuffed by SF8 ROM 
CLC ;signal an output 
BCS * sskip SEC 
ORG *-1 
BIN SEC ;signal an input 
STA CHAR ssave the char 
TYA ;save Y 
PHA 
TXA ;save X 
PHA 
C8BASIC EQU #* *BASIC IN/OUT 


TEST EQU O 


* 
*& 
* 
* 
* 


BCS BINPUT ;=>input a character 
-REAL VERS LON 

LST ON,A,V 

INCLUDE BPRINT 


This is the place where characters printed using the 
CSW hook are actually printed (or executed if they are 
control characters). 


BPRINT JSR CSETUP ;setup user cursor 
LDA CHAR ;GET CHARACTER 
CMP #S8D ‘1S: IT G/R? 


BNE NOWALT s=>don't wait, OURCH ok 
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C888: 
C88B: 
C88D: 
C88F: 
C891: 
C894: 
C897: 
C899: 
C89B: 
C89D: 
C8A0: 
C8A2: 
C8A4: 
C8A6: 
C8A9: 
C8AC: 
C8AC: 
C8AC: 
C8AC: 
C8AC: 
:20 
C8B2: 
C8B2: 
C8B2: 
C8B2: 
C8B3: 
C8B6: 
C8B8: 
C8BA: 
C8BD: 
C8BD: 
C8BD: 
C8BD: 
C8BD: 
C8CO0: 
C8C2: 
C8C5: 
c8cs: 
C8CB: 
C8CD: 
C8CF: 
C8D1: 
C8D4: 
C8D5: 
C8D6: 
C8D/7: 
C8D8: 
C8DB: 
C8DC: 
C8DC: 
C8DC: 
C8DC: 
C8DC: 
C8DC: 


C8AF 


AD 


A4 


7B 
38 


7B 


24 


C8BD 


C8CF 


06 


KBDWAIT 


NOWAIT 


k 


* NOT A 
* 


BPNCTL 


CTL 


EQU 
LDA 
JSR 


CHAR. 


KBD 
NOWAIT 
#$93 
NOWAIT 
KBDSTRB 
KBD 
KBDWAIT 
#$83 
NOWAIT 
KBDSTRB 
#S7F 
#$20 
BPNCTL 


CTLCHARO 


CTLON 


* 
CHAR 


STORCHAR 


;1S KEY PRESSED? 

; NO 

31S IT CTL-S? 

3;NO, IGNORE IT 

;CLEAR STROBE 

;WAIT FOR NEXT KEYPRESS 


;1F CTL-C, LEAVE IT 

; IN THE KBD BUFFER 
;CLEAR OTHER CHARACTER 
;drop possible hi bit 
;IS IT CONTROL CHAR? 
3=>NOPE 

sexecute CTL if M.CTL ok 
;=>enable ctl chrs 


PRINT IT. 


3;get char (all 8 bits) 
sand display it 


* BUMP THE CURSOR HORIZONTAL: 


* + & + 


CTLON 


BIORET 


SETALL 


GETREGS 


+ ee 


INY 
STY 
CPY 
BCC 
JSR 


LDA 
AND 
STA 
LDA 
BIT 
BPL 
LDA 
STA 
STA 
PLA 
TAX 
PLA 
TAY 
LDA 
RTS 


INCLUDE BINPUT 


OURCH 
WNDWDTH 
CTLON 
XeCR 


MODE 


#255-M.CTL 


MODE 
OURCH 


RD80VID 


SETALL 
#0 

CH 
OLDCH 


CHAR 


;bump it 

;are we past the 

; end of the line? 
3=>NO, NO PROBLEM 
sYES, DO C/R 


M.CTL is set by RDCHAR and cleared here, after each 
character is displayed. 


;enable printing of control chars 


;get newest cursor position 
;IN 80-MODE? 

3=>no, set other cursors 
;pin CH to O for 80 columns 


;REMEMBER THE SETTING 
; RESTORE 


3X AND Y 


;RETURN TO BASIC 


BASIC input entry point called by entry point in the 
$C3 space. 


This is the way things normally happen. 


BINPUT LDY CH 
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C8DE:AD 7B 06 6 LDA CHAR 

C8E1:91 28 7 STA (BASL),Y 

C8E3:20 50 C8 8 JSR CSETUP sget newest cursor 

C8E6:20 26 CE 9 Be INPUT JSR INVERT sinvert that char 

C8E9:20 3B C8 10 JSR GETKEY ;GET A KEY 

C8EC:8D 7B 06 11 STA CHAR ;SAVE IT 

C8EF:20 26 CE 12 JSR INVERT ;REMOVE CURSOR 

C8F2:A8 13 TAY ;preserve acc. 

C8F3: 14 * 

C8F3: 15 * On pure input, an uninterpreted character code should 
C8F3: 16 * be returned. If M.CTL is set, however, escape functions 
C8F3: 17 * are enabled, and CTL-U causes the character under the 
C8F3: 18 * cursor to be picked up from the screen. 

C8F3: 19 * M.CTL is set whenever a character is requested using 
C8F3: 20 * RDCHAR in the S$F8 ROM. 

C8F3: 21 * 

C8F3:AD FB 04 22 LDA MODE 3is escape mode enabled? 
C8F6:29 08 23 AND #M.CTL 

C8F8:FO CB C8C5 24 BEQ BIORET 3=>no,return 

C8FA:CO 8D 25 CPY #$8D swas it a CR 

C8FC:D0 08 C906 26 BNE NOTACR ;=>nope, not a CR 

C8FE:AD FB 04 27 LDA MODE 

C901:29 F7 28 AND #255-M.CTL ;else end of line... 
C903:8D FB 04 29 STA MODE ; disable escape 

C906: C906 30 NOTACR EQU * 

C906:CO 9B 31 cPy #S9B sESCAPE KEY? 

C908:F0 11 C91B a2 BEQ ESCAPING ;=>YES IT IS 

C9OA: 33 * 

C90A: 34 * Not an escape sequence. Check for control-u. 
C9IOA: 35 * 

C90A:CO 95 36 CPy #$95 sis it control-U? 

C90C:DO B7 C8C5 37 BNE BIORET sno, return to caller 
C9OE:AC 7B 05 38 LDY OURCH sget horizontal position 
C911:20 44 CE 39 JSR PICK sand pick up the char 
C914:09 80 40 ORA #S80 salways pick as normal 
C916:8D 7B 06 41 STA CHAR ;save keystroke 

C919:DO AA cC8C5 42 BNE BIORET ;=>(always) return to caller 
C9O1B: 43 * 

C91B: 44 * Start an escape sequence. If the next character 
C9O1B: 45 * pressed is one of the following, it is executed. 
C9OLB: 46 * Otherwise it is ignored. 

C9OLB: 47 % 

C9O1B: 48 * @ - home & clear 

C91B: 49 * E - clear to end of line 

C91B: 50 * F - clear to end of screen 

C9O1B: 51 * I - move cursor up 

C91B: 52 * J - move cursor left 

C9O1B: 53 * K - move cursor right 

C91B: 54 * M - move cursor down 

CO1B: 57 * 4 - enter 40 column mode 

C91B: 58 * 8 - enter 80 column mode 

C9O1B: 59 * CTL-D- disable the printing of control characters 
COLB: 60 * CTL-E- enable the printing of control characters 
C9O1B: 61 * CTL-Q- quit (PR#0/IN#0) 
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C91B: 62 * The four arrow keys (as IJKM) 

COLB: 63 * 

CO1B: 64 MSB OFF 

C9O1B: C91B 65 ESCAPING EQU * 

C91B:20 Bl CE 66 JSR ESCON ;ESCAPE CURSOR ON 

C91E:20 3B C8 67 JSR GETKEY ;GET ESCAPE FUNCTION 
C921:20 C4 CE 68 JSR ESCOFF ;REPLACE ORIGINAL CHARACTER 
C924:20 14 CE 69 JSR UPSHFT supshift the char 

C927:29 7F 70 AND #S7F sDROP HI BIT 

C929:A0 10 71 LDY #ESCNUM-1 ;COUNT/ INDEX 

C92B:D9 7C C9 72 ESC2 CMP ESCTAB,Y ;I1S IT A VALID ESCAPE? 
C92E:FO 05 C935 73 BEQ  ESC3 3S=>YES 

C930 :88 74 DEY 

C931:10 F8 C92B 75 BPL ESC2 sTRY 'EM ALL... 

C933:30 OF C944 76 BMI ESCSPEC s=>MAYBE IT'S A SPECIAL ONE 
C935: 77 * 

C935: C935 = 78 ~ESC3 EQU * 

C935:B9 6B C9 79 LDA ESCCHAR,Y ;GET CHAR TO "PRINT" 
C938:29 7F 80 AND #S7F ;DROP HI BIT (FLAG) 

C93A:20 D6 CA 81 JSR CTLCHAR ;EXECUTE IT 

C93D:B9 6B C9 82 LDA ESCCHAR,Y ;GET FLAG 

C940:30 D9 C9I1B 83 BMI ESCAPING ;=>STAY IN ESCAPE MODE 
C942:10 A2 C8E6 84 BPL B.INPUT s=>QUIT ESCAPE MODE 

C944; 85 * 

C944; C944 86 ESCSPEC EQU * 

C944:A8 87 TAY ;put char here 

C945:AD FB 04 88 LDA MODE 3sO we can put this here 
C948:C0 11 89 cPy #$11 swas it Quit? 

C94A:D0 OB C957 90 BNE ESCSP1 $=>no 

C94C:20 4D CD 91 JSR X.NAK ;do the quitting stuff 
C9O4F:A9 98 92 LDA #$98 smake it look like 

C951:8D 7B 06 93 STA CHAR ;CTL-X was pressed 

C954:4C C5 C8 94 JMP BIORET ;=>quit the card forever 
C957: 95 * 

C957:C0 05 96 ESCSP1 cCPY #S$05 swas it CTL-E for enable 
C959:D0 08 C963 97 BNE ESCSP4 3=>no 

C95B:29 DF 98 AND #255-M.CTL2 ;yes, enable ctl chars 
C95D:8D FB 04 99 ESCSP2 STA MODE ;save new mode 

C960:4C E6 C8 100 ESCSP3 JMP B.INPUT 3=> exit escape mode 

C963: 101 * 

C963:CO 04 102 ESCSP4 cCPY #$04 swas it CTL-D for disable 
C965:DO F9 c960—s:1103 BNE ESCSP3 3=>no, exit escape mode 
C967:09 20 104 ORA #M.CTL2 sdisable ctl chars 

C969:D0 F2 C95D 105 BNE ESCSP2 3=> exit escape mode 

C96B: 106 * 

C96B: 107 * This table contains the control characters which, 
C9O6B: 108 * when executed, carry out the escape functions. If 
C96B: 109 * the high bit of the character is set, it means that 
C96B: 110 * escape mode should not be exited after execution of 
C96B: 111 * the character. 

C9I6B: 112 * 

C96B: C96B 113 ESCCHAR EQU * 

C96B:0C 114 DFB SOC 3@: FORMFEED 

C96C:1C 115 DFB SIC sA: FS 
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C96D:08 116 DFB $08 3B: BS 

C96E:0A 117 DFB SOA “Cy. LF 

C96F:1F 118 DFB SIF 3D: US 

C970:1D 119 DFB $1D sE: GS 

C971:0B 120 DFB SOB 3F: VT 

C972:9F 121 DFB $1F+$80 sI: US (STAY ESC) 
C973:88 122 DFB $08+$80 ;J: BS (STAY ESC) 
C974:9C 123 DFB $1C+$80 ;K: FS (STAY ESC) 
C975:8A 124 DFB S$0OA+S$80 sM: LF (STAY ESC) 
C976:11 125 DFB $11 34 :DCl 

C977:12 126 DFB $12 358 :DC2 

C978:88 127 DFB $08+$80 3<-:BS (STAY ESC) 
C979:8A 128 DFB S$0OA+S$80 ;DN: LF (STAY ESC) 
C97A:9F 129 DFB S$1F+$80 ;UP:US (STAY ESC) 
C97B:9C 130 DFB $1C+$80 s->:FS (STAY ESC) 
C97C: 131 * 

C97C: 132 MSB OFF shigh bit already masked 
C97C: c97C 133 ESCTAB EQU * 

C97C:40 134 ASC ‘@! 

C97D:41 135 ASC ‘A! ;HANDLE OLD ESCAPES 
C97E:42 136 ASC 'B! 

C97F:43 137 ASC ‘C' 

C980 :44 138 Asc 'D! 

C981:45 139 ASC 'E' 

C982:46 140 ASC 'F! 

C983:49 14] Asc 'I' 

C984:4A 142 ASC ‘'J' 

C985:4B 143 ASC 'K' 

C986:4D 144 ASC '‘M' 

C987 :34 145 ASC ‘4! 

C988:38 146 Asc ‘8! 

C989:08 147 DFB $08 ;LEFT ARROW 
C9BA:0A 148 DFB SOA ;DOWN ARROW 
C98B:0B 149 DFB $OB -UP ARROW 
C98C:15 150 DFB $15 ;sRITE ARROW 

C98D: 0011 151 ESCNUM EQU *-ESCTAB 

C98D: 152 MSB ON 

C98D: 153 * 

C98D: 154 * Tack on diag 128K test here 

C98D: 155 * 

C98D:2C 13 CO 156 STAUX BIT RDRAMRD ;aux done yet? 
C990:30 11 C9A3 157 BMI XSTAUX s=>yes, exit 
C992:A9 EE 158 LDA #SEE sget test pattern 
C994:8D 05 CO 159 STA WRCARDRAM ;write AUX RAM 
C997:8D 03 CO 160 STA RDCARDRAM ;read AUX RAM 
C99A:8D 00 OC 161 STA $C00 ;test this byte 
C99D:8D 00 08 162 STA $800 sand this is IK off 
C9A0:CD 00 OC 163 CMP $COO shas $COO been updated? 
C9A3:60 164 XSTAUX RTS ;check in main diags. 
C9A4: 165 * 

C9A4: 166 * ESCOUT used by ESCFIX in $Cl page 
C9A4: 167 * 

C9IA4: 168 MSB ON 

C9A4:CA CB CD C9 169 ESCOUT ASC ‘'‘JKMI' ;The arrows 
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:A9 
:DO 


:A9 


248 


:20 
: FO 
268 
:A2 
:60 


:68 
:8D 
:8D 
:8D 
:8D 
220 
220 
24C 


‘20 
220 
229 
:8D 


7B 
56 


83 
02 


81 


90 
04 


09 


FB 
01 
OD 
OF 
D4 
90 
1F 


D4 
3B 
7F 
7B 


0002 
0000 


06 
C3 


C9IBO 


C9IB6 
CIB4 


C9IB6 


CA 
C9ICO 


C9CO 


04 
co 
co 
co 
CE 
CC 
CA 


170 
26 


omn~”nW” &WwNhM e 


10 
ll 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
ZZ 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4] 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 


MSB 


OFF 


INCLUDE PASCAL 
KHKKKKKKKKKRKKKREKERKEREKEREKKEEERIKERERRE RK 


* PASCAL 1.0 OUTPUT HOOK: 
KRKARKEKRAKKEKERERERERRERERERRRERERRERKEKK 


DS 


C80RG+$1 AA-* ,0 


IFNE *-C80RG-S1AA 
FAIL 2,'C9AA HOOK ALIGNMENT’ 


FIN 
LDA 
JMP 


CHAR ;GET OUTPUT CHARACTER 
JPWRITE 3=>USE STANDARD WRITE 


KEKKKEKRERKEKKKEERERREKRKEKKEKKERERKEREREKAKKKKE 


*& 


REEREKREKRRKEREEREREREREEKKERERERRRKERKKRKRKKE 


* PASCAL INITIALIZATION: 


* Disable printing of mouse text 
KERKKRKKKRKEERKEEKRRREKREKREKREREKKIRKKEKAKKK 


PINITL.O EQU * 


PINIT 


* 
PINIT2 


* 


LDA 
BNE 
EQU 
LDA 


EQU 
PHA 


#M.PASCAL+M. PAS] .O+M. MOUSE 


PINIT2 ;=Dalways 
k 


#M.PASCAL+M.MOUSE ;SAY WE'RE 


& 
;save version ID 


* SEE IF THE CARD'S PLUGGED IN: 


* 


& 
PIGOOD 


JSR 
BEQ 
PLA 
LDX 
RTS 


EQU 
PLA 
STA 
STA 
STA 
STA 
JSR 
JSR 
JMP 


TESTCARD ;I1S IT THERE? 
PIGOOD ;=>YES 
;discard ID byte 
#9 ; LORESULT='NO DEVICE' 


;get version ID 
MODE ; and save it 
SET80COL ;ENABLE 80 STORE 


SET80VID ; AND 80 VIDEO 
SETALTCHAR ;NORM+INV LCASE 
PSETUP ;set window and cursor 
X.FF ;HOME & CLEAR IT 


DOBASL ;fix OLDBASL/H, display cursor, exit 


KHEKKKKKKKREKKKKKREKKEKKREKEREEREKKICRRARERKEKK 
* PASCAL INPUT: 


* 


* Character always returned with high bit clear. 


* 


KREEKKEKKREKEREKREREKEKREREREREKKK KKK KKREKK 


PREAD 


EQU 
JSR 
JSR 
AND 
STA 


* 

PSETUP ;OETUP ZP STUFF 
GETKEY ;GET A KEYSTROKE 
#S7F ;DROP HI BIT 
CHAR ;SAVE THE CHAR 
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C9E1 :A2 
C9E3: AD 
C9E6:29 
C9E8 : FO 
C9EA:A2 
C9EC: 

C9EC: 

C9EC: AD 
C9IEF:60 
C9FO: 

C9FO: 

C9FO: 

C9FO: 

C9FO: 

C9FO: 

C9FO: 

C9FO:29 
C9OF2:AA 
C9F3:20 
C9OF6:A9 
C9F8:2C 
C9FB: DO 
COFD:8A 
C9OFE:2C 
CAO1:FO 
CAO3 : AC 
CA06:24 
CA08 :10 
CAOA:09 
CAO0C:20 
CAOF:C8 
CA10:8C 
CA13:C4 
CAL5:90 
CA17:A9 
CA19:8D 
CA1C:20 
CAILF:A5 
CA21:8D 
CA24:A5 
CA26:8D 
CA29:20 
CA2C:A2 
CA2E:60 
CA2F: 

CA2F: 

CA2F: 

CA2F:20 
CA32:8A 
CA33:38 
CA34:E9 
CA36:2C 
CA39:30 
CA3B: 


326 


20 


30 


04 


C9EC 


C9EC 
06 


C9FO 


CE 


04 
CA2F 


CA 
CA53 

05 
CAOC 

CE 

05 
CALIF 


05 
CB 


07 


07 
CE 


CE 


06 
CA6B 


LDX 
LDA 
AND 
BEQ 


LDX 
* 


#0 
MODE 


#M.PAS1.0 
PREADRET2 


#<CNOO 


PREADRET2 EQU * 


LDA 
RTS 


Note: 


+ +e + + & 


PWRITE EQU 
AND 
TAX 
JSR 
LDA 
BIT 
BNE 
TXA 
BIT 
BEQ 
LDY 
BIT 
BPL 
ORA 
JSR 
INY 
STY 
CPY 
BCC 
LDA 
STA 
JSR 
LDA 
STA 
LDA 
STA 


PWRI 


DOBASL 


CHAR 


PASCAL OUTPUT: 
to be executed, control characters must have 
their high bits cleared. 
displayed regardless of their high bits. 


& 


#S7F 


PSETUP 
#M.GOXY 
MODE 
GETX 


PRTS 
PCTL 
OURCH 
INVFLG 
PWRI 
#$80 
STORIT 


OURCH 
WNDWDTH 
DOBASL 
#0 
OURCH 
X.LF 
BASL 
OLDBASL 
BASH 
OLDBASH 


PWRITERET JSR PASINV 


PRET 
PRTS 
* 


LDX 
RTS 


* HANDLE GOTOXY STUFF: 


k 
GETX 


#$0 


PAS INV 


#32 
XCOORD 
PSETX 


; LORESULT='GOOD' 
;ARE WE IN 1.0-MODE? 


3 =>NOPE 
;YES, RETURN CN IN X 


;RESTORE CHAR 


All other characters are 


;clear high bits 

;save character 

;SETUP ZP STUFF, don't set ROM 
;ARE WE DOING GOTOXY? 


3=>Doing X or Y? 

snow check for control char 
sis it control? 

;=>yes, do control 

;get horizontal position 
scheck for inverse 
sinverse, go store it 


snow store it (erasing cursor) 
-INC CH 


;do carriage return 


sand linefeed 
;save BASL for pascal 


;display new cursor 
;return with no error 


sturn off cursor 
sget character 


sMAKE BINARY 
sdoing X? 
3=>yes, set it 
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CA3B: 107 * Set Y and do the GOTOXY 


CA3B: 108 * 

CA3B:8D FB 05 109 GETY STA OURCV 

CA3E:85 25 110 STA CV 

CA40:20 BA CA lll JSR BASCALC scalc base addr 

CA43:AD FB 06 112 LDA XCOORD 

CA46:8D 7B O05 113 STA OURCH sset cursor horizontal 
CA49:A9 F7 114 LDA #255-M.GOXY ;turn off gotoxy 

CA4B:2D FB 04 115 AND MODE 

CA4E:8D FB 04 116 STA MODE 

CA51:DO CC CAIF 117 BNE DOBASL s=>DONE (ALWAYS TAKEN) 
CA53: 118 * 

CA53:20 1F CE 119 PCTL JSR PASINV sturn off cursor 

CA56:8A 120 TXA ;get char 

CA57:C9 1E 121 CMP #S1E sis it gotoXY? 

CA59:FO 06 CA61 122 BEQ STARTXY ;=>yes, start it up 

CA5B:20 D6 CA 123 JSR CTLCHAR sEXECUTE IT IF POSSIBLE 
CASE:4C IF CA 124 JMP DOBASL ;=>update BASL/H, cursor, exit 
CA61: 125 * 

CA61: 126 * START THE GOTOXY SEQUENCE: 

CA61: 127 * 

CA61: CA61 128 STARTXY EQU * 

CA61:A9 08 129 LDA #M.GOXY 

CA63:0D FB 04 130 ORA MODE ;turn on gotoxy 

CA66:8D FB 04 131 STA MODE 

CA69:A9 FF 132 LDA #SFF sset XCOORD to -l 

CA6B:8D FB 06 133 PSETX STA XCOORD ;set X 

CA6E:4C 29 CA 134 JMP PWRITERET ;=>display cursor and exit 
CA71: 27 INCLUDE SUBS1 

CA71: CA7 1 1 DOMN EQU * 

CA71:AA 2 TAX ;SAVE IT 

CA72:A5 2A 3 LDA BAS2L ;GET OPCODE AGAIN 

CA74:A0 03 4 LDY #$03 

CA76:E0O 8A a CPX #S8A 

CA78:FO OB CA8 5 6 BEQ MNNDX3 

CA7A:4A 7 MNNDX] LSR A 

CA7B:90 08 CA8 5 8 BCC MNNDX3 ;FORM INDEX INTO MNEMONIC TABLE 
CA7D:4A 9 LSR A 

CA7E:4A 10 MNNDX2 LSR A ; 1) 1XXX1010 => 00101XxXxX 
CA7F:09 20 ll ORA #$20 ; 2) XXxyyyY0Ol => 00111Xxx 
CA81:88 12 DEY s 3) XXXYYY1O => 00110XXx 
CA82:DO FA CA7 E 13 BNE MNNDX2 ; 4) XxxyYl00 => 00100XXx 
CA84:C8 14 INY ; 5) XXXXX000 => OOOXXXXX 
CA85:88 15 MNNDX3 DEY 

CA86:DO F2 CA7 A 16 BNE MNNDX1 

CA88 : 60 17 RTS 

CA89: 18 * 

CA89: 19 * Switch in slot 3, then test for a ROM card. 
CA89: 20 * If none found, test for 80 column card, 

CA89: 21 * else return with BNE. 

CA89: 22 * 

CA89: CA8 9 23 TSTROMCRD EQU * 

CA89:20 B/7 F8 24 JSR TSTROM stest for ROM card 

CA8C:DO 02 CAI 0 25 BNE TESTCARD 3;=>no ROM, check for 80 column card 
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CA8E:C8 26 INY smake BNE for return 


CA8F:60 27 RTS 
CA90: 28 * 
CA90: DQ KKKKKKAKKRKRERRRKERERRRKERERERER REREKREKRER 
CA90: 30 * NAME : TESTCARD 
CA90: 31 * FUNCTION: SEE IF 80COL CARD PLUGGED IN 
CA90: 32 * INPUT : NONE 
CA90: 33 * OUTPUT : 'BEQ' IF CARD AVAILABLE 
CA90: 34 * : 'BNE' IF NOT 
CA90: 35 * VOLATILE: AC,Y 
CA90: 36 RRAKKKKKHKKAKKRKREKERKERERRRERERAERERERKKK 
CA90: 37 * 
CA90: CA9I0 38 TESTCARD EOU * 
CA90:AD 1C CO 39 LDA RDPAGE2 ;REMEMBER CURRENT VIDEO DISPLAY 
CA93:0A 40 ASL A ; IN THE CARRY 
CA94:A9 88 41 LDA #588 sUSEFUL CHAR FOR TESTING 
CA96:2C 18 CO 42 BIT RD80COL ;REMEMBER VIDEO MODE IN '‘'N' 
CA99:8D 01 CO 43 STA SET80COL ;ENABLE 80COL STORE 
CA9IC:08 44 PHP ;SAVE 'N* AND 'C' FLAGS 
CA9D:8D 55 CO 45 STA TXTPAGE2 ;SET PAGE2 
CAAO:AC 00 04 46 LDY $0400 ;GET FIRST CHAR 
CAA3:8D 00 04 47 STA $0400 sSET TO A '*! 
CAA6:AD 00 04 48 LDA $0400 ;GET IT BACK FROM RAM 
CAA9:8C 00 04 49 STY $0400 sRESTORE ORIG CHAR 
CAAC :28 50 PLP ;RESTORE 'N' AND 'C' FLAGS 
CAAD:B0O 03 CAB2 51 BCS STAY2 sSTAY IN PAGE2 
CAAF:8D 54 CO 52 STA TXTPAGE]L ;RESTORE PAGE] 
CAB2: CAB2 53 STAY2 EQU * 
CAB2:30 03 CAB/ 54 BMI STAY80 ;=>STAY IN 80COL MODE 
CAB4:8D 00 CO 55 STA CLR80COL ;TURN OFF 80COL STORE 
CAB/7: CAB/ 56 STAY80 EQU * 
CAB/:C9 88 57 CMP #S$88 ;WAS CHAR VALID? 
CAB9 :60 58 RTS ;RETURN RESULT AS BEQ/BNE 
CABA: 59 * 
CABA: 60 * Do the 
normal monitor ROM BASCALC 
CABA: 61 * 
CABA: CABA 62 BASCALC EQU * 
CABA:48 63 PHA 
CABB:4A 64 LSR A 
CABC:29 03 65 AND #$03 
CABE:09 04 66 ORA #S04 
CACO:85 29 67 STA BASH 
CAC2 :68 68 PLA 
CAC3:29 18 69 AND #518 
CAC5:90 02 CAC9 70 BCC BSCLC2 
CAC7:69 7F 71 ADC #S$7F 
CAC9:85 28 72 BSCLC2 STA BASL 
CACB:0A 73 ASL A 
CACC:0A 74 ASL A 
CACD:05 28 75 ORA BASL 
CACF:85 28 76 STA BASL 
CAD1:60 77 RTS 
CAD2: 78 * 


328 Appendix I: Monitor ROM Listings 


<2C 
250 


:B8 
:8D 
748 
298 
748 


: AC 
:CO 
:90 


:B9 


SFO 
250 


330 


:8D 


: AD 


329 


: FO 


238 


: BO 


: AD 


06 CB 

FE CAD5 
CAD6 

7B 07 

7B 07 

05 

13 CAF/ 

B4 CB 

OE CAF/ 

12 CAFD 
0000 

10 CAFD 

7B 07 

FB 04 

28 

03 CAFA 
CAF/7 

09 CB03 

7B 07 
CAFD 


KRERERRKEREKREEREKRREREKRKEERKRKRERKRERRERERER 


: CTLCHARO 
FUNCTION: 


NAME 


INPUT 


Execute C 


: AC=CHAR 


VOLATILE: 


CALLS 


* 


* 
* 
* 
* OUTPUT 
* 
* 
* 


"BCS' if 
"BCC' if 
NOTHING 


TL char if M.CTL=0 


not executed 
executed 


: MANY THINGS 
KHKKKAKKKKKEKRERERKERREREREKE KK RREKEKKKKKK 


CTLCHARO BIT SEV1 


& 


BVC 
ORG 


* 
|} 


sset V (use M.CTL) 
;skip CLC 


KAKKKKKKKKKKKKKKEKEKRERERKRKKKK KKK AKKKKKKKK 
: CTLCHAR 


NAME 


INPUT 


+ + FF F 


FUNCTION: 


Always ex 


: AC=CHAR 
"BCS' if not executed 


OUTPUT 


* VOLATILE: 


* CALLS 


* 


"BCC' if 
NOTHING 


ecute CTL char 


ctl executed 


: MANY THINGS 
KHRKARKKKKKK KKK EK EKEEKRERKEKREEKK KARR KKK KK 


CTLCHAR CLV 


* 


STA 
PHA 
TYA 
PHA 


LDY 
CPY 
BCC 
LDA 
BEQ 
BVC 


DO 
BPL 


TEMP 1 


TEMP 1 
#$05 
CTLCHARX 
CTLADH-5 
CTLCHARX 
CTLGOO 


TEST 
CTLGOO 


ELSE 


BMI 
FIN 


STA 
LDA 
AND 
BEQ 


CTLGOO 


TEMP] 
MODE 
#M.CTL+M 
CTLGO 


CTLCHARX EQU * 


* 


CTLGO 
CTLGOO 


SEC 
BCS 


LDA 
EQU 


CTLRET 


TEMP1 
* 
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sclear V (ignore M.CTL) 
;TEMP SAVE OF CHAR 
s;SAVE AC 

“SAVE Y 


;GET CHAR IN QUESTION 
;IS IT NUL..EOT? 
s=DYES, NOT USED 
»Y ;Get high byte of address 
;=>ctl not implemented 
;=> CLTCHAR: always execute 


;=>CR,BEL,LF,BS always done 
3=>CR, BEL,LF,BS always done 
;save high byte of address 

3if control chars 


~CTL2 ;are enabled 
;=>then go do them 


;SAY ‘NOT CTL' 
3=>DONE 


sget address back 
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329 


330 


0000 


:09 80 


720 O7 CB 


CBO3 


CBO7 


:B9 99 CB 


:AD FB 04 

710 05 CBl7 
729 EF 

:8D FB 04 


:AD FB 04 
2:10 FA CB17 


:DO F3 CB14 


CB21 


:20 34 CB 


720 34 CB 
:AD 30 CO 


:DO F5 CB28 


CB34 


:E9 Ol 
:DO FC CB36 


DO 
AND 


ELSE 


ORA 


CTLRET EQU 


SEV1 RTS 
* 


CTLXFER EQU 


* 


TEST 
#S7F 


#$80 


CTLXFER 


* 


;for test, hi bit clear 
shi bit always set 
;EXECUTE SUBROUTINE 
;SAY ‘CTL CHAR EXECUTED' 
; RESTORE 


i a 
; AND AC 


;PUSH ONTO STACK FOR 


CTLADL-5,Y ; TRANSFER TRICK 


;XFER TO ROUTINE 


* Turn cursor on for Pascal only 


* 


X.CUR.ON LDA MODE 


BPL 
AND 


~SAVCUR STA 


CURON.X RTS 
* 


CURON.X 


;get mode byte 
3=>not pascal, don't do it 


#255-M.CURSOR ;clear cursor bit 


MODE 


;save it 
sand exit 


* Turn cursor off for Pascal only. 
* Cursor is not displayed during call. 


* 


X-CUR.OFF LDA MODE 


BPL 
ORA 


BNE 
* 


CURON.X 


;get mode byte 
s=>not pascal, don't do it 


#M.CURSOR ;turn on cursor bit 


SAVCUR 


* EXECUTE BELL: 


* 

XeBELL EQU 
LDA 
JSR 
LDY 

BELL2 LDA 
JSR 
LDA 
DEY 
BNE 
RTS 


WAIT EQU 
SEC 
WAIT2 PHA 
WAIT3 SBC 
BNE 


x 

#$40 
WAIT 
#$C0 
#SOC 
WAIT 
SPKR 


BELL2 
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;save and exit 


;RIPPED OFF FROM MONITOR 


;RIPPED OFF FROM MONITOR ROM 


Monitor ROM Listings 


CB3A: 
CB3B: 
CB3D: 
CB3F: 
CB40: 
CB40: 
CB40: 
CB40: 
CB40: 
CB43: 
CB45: 
CB47: 
CB4A: 
CB4D: 
CB50: 
CB50: 
CB51: 
CB51: 
CB51: 
CB51: 
CB51: 
CB53: 
CB56: 
CB59: 
CB5B: 
CB5E: 
CB5E: 
CB5F: 
CBSF: 
CBSF: 
CB5F: 
CB5F: 
CB6l: 
CB63: 
CB65: 
CB68: 
CBO6B: 
CBOB: 
CB6B: 
CB6B: 
CBOB: 
CB6E: 
CB/71: 
CB73: 
CB/5: 
CB78: 
CB/78: 
CB78: 
CB/9: 
CB/9: 
CB/79: 
CB79: 
CB/7B: 
CB/N: 


C5 
BO 


01 
F6 


22 


1E 


CB35 


CBSF 


CB9D 


* 


PLA 
SBC 
BNE 
RTS 


#1 
WAIT2 


* EXECUTE BACKSPACE: 


* 


X-BS 


BSDONE 


* 


EQU 
DEC 
BPL 
LDA 
STA 
DEC 
JSR 
EQU 
RTS 


* 


OURCH ;BACK UP CH 

BSDONE ;=>DONE 

WNDWDTH ;BACK UP TO PRIOR LINE 
OURCH ;9ET CH 

OURCH 

X.US ;NOW DO REV LINEFEED 


*& 


* EXECUTE CARRIAGE RETURN: 


* 
X-eCR 


XeCRRET 


* 


EQU 
LDA 
STA 
LDA 
BMI 
JSR 
EQU 
RTS 


* 


#0 ;BACK UP CH TO 

OURCH ; BEGINNING OF LINE 

MODE sARE WE IN BASIC? 

XeCRRET 3=> Pascal, avoid auto LF 
X.LF ;EXECUTE AUTO LF FOR BASIC 


* 


* EXECUTE HOME: 


k 
Xe EM 


* 


EQU 
LDA 
STA 
LDA 
STA 
JMP 


* 


WNDTOP 

CV 

#0 

OURCH ;sSTUFF CH 

VTAB ;set base for OURCV 


* EXECUTE FORWARD SPACE: 


* 
X.FS 


* 
Xe FSRET 


* 


EQU 
INC 
LDA 
CMP 
BCC 
JSR 


EQU 
RTS 


* 


OURCH ;BUMP CH 

OURCH ;GET THE POSITION 
WNDWDTH ;OFF THE RIGHT SIDE? 
Xe FSRET s=>NO, GOOD 

X-CR 3=>YES, WRAP AROUND 


* 


* EXECUTE REVERSE LINEFEED: 


* 
X.US 


LDA 
CMP 
BCS 
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WNDTOP sare we at top? 
CV 
X.USRET s=>yes, stay there 


33] 


CB/F: 
24C 
CB84: 
CB84: 
CB84: 
CB84: 
CB84: 
CB87: 
CB89: 
CB8B: 
CB8D: 
CB8F: 
CB8F: 
CB8F: 
CB8F: 
CB8F: 
CB92: 
CB94: 
CB96: 
CB98: 
CB9OB: 
CB9D: 
CB9E: 
CB9E: 
CB9E: 
CB9F: 
CBAO: 
CBAIL: 
CBA2: 
CBA3: 
CBA4: 
CBA5: 
CBA6: 
CBA7: 
CBA8: 
CBA9: 
CBAA: 
CBAB: 
CBAC: 
CBAD: 
CBAE: 
CBAF: 
CBBO: 
CBBl: 
CBB2: 
CBB3: 
CBB4: 
CBB5: 
CBB6: 
CBB/7: 
CBB8: 
CBB9: 
CBB9: 
CBB9: 


CB81 


302 


C6 


25 
FE 


CD 


CB9E 


CBB9 


* 


DEC 
JMP 


CV ;else go up a line 
VTAB sexit thru VTAB (update OURCV) 


* EXECUTE "NORMAL VIDEO" 


* 
X.SO 


X.SOl 


* 


EQU 
LDA 
BPL 
AND 
LDY 
BNE 


* 


MODE ;SET MODE BIT 

X.SOl sdon't set mode for BASIC 
#255-M.VMODE ;SET '‘NORMAL' 

#255 


STUFFINV ;( ALWAYS) 


* EXECUTE “INVERSE VIDEO" 


k 
X.SI 


X.SI1 


STUFFINV STA 


Xe USRET 
* 


CTLADL 


* 


MODE ;SET MODE BIT 

X.SI1 sdon't set mode for BASIC 
#M.VMODE ;SET 'INVERSE' 

#127 

MODE ;SET MODE 


INVFLG ;STUFF FLAG TOO 


* 


#>X.CUR.ON-1 ;ENQ 
#>X.CUR.OFF-1 ;ACK 
#>X.BELL-1 ;BEL 
#>X.BS-1 ;BS 

0 ;HT 
#>X.LF-1 ;LF 
#>X.VT-L ss VT 
#>X.FF-1 ;FF 
#>X.CR-1  ;CR 
#>X.SO-1 ;SO 
#>X.SI-1 ;SI 

0 ; DLE 
#>X.DC1-1 ;DCl 
#>X.DC2-1 ;DC2 

0 3DC3 

0 ;DC4 
#>X.NAK-1  ;NAK 
#>SCROLLDN-1 ;SYN 
#>SCROLLUP-1 ;ETB 
##>MOUSEOFF-1 
#>X.EM-1 ;EM 
#>X.SUB-1 ;SUB 
##>MOUSEON-1 
#>X.FS-1 =; FS 
#>X.GS-1 sGS 

0 RS 
#>X.US-1 ;US 


* 
#<X.CUR.~ON-$8001 ;ENQ 
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CBBA: 
CBBB: 
CBBC: 
CBBD: 
CBBE: 
CBBF: 
CBCO: 
CBCI1: 
CBC2: 
CBC3: 
CBC4: 
CBC5: 
CBC6: 
CBC7: 
CBC8: 
CBC9: 
CBCA: 
CBCB: 
CBCC: 
CBCD: 
CBCE: 
CBCF: 
CBDO: 
CBD1: 
CBD2: 
CBD3: 
CBD4: 
CBD4: 
CBD4: 
CBD4: 
CBD4: 
CBD4: 
CBD4: 
: AO 


CBD4 


CBD6: 
CBD8: 
CBD8: 
CBD8: 
CBD8: 
CBD8: 
CBDA: 
CBDC: 
CBDF: 
CBE]: 
CBE3: 
CBE6: 
CBE6: 
CBE6: 
CBE9: 
CBEB: 
CBEB: 
CBED: 
CBEE: 
CBEF: 


FO 


00 
15 


01 


7B 


05 


CE 


05 


07 


CBED 


CBD& 


CBEG 


CBE®G 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


INCLUDE SUBS2 


* 

* 

* 

*& 

& 

* 

SCROLLDN LDY 
BEQ 

* 

* EXECUTE LI 

& 

X.LF  EQU 
INC 
LDA 
STA 
CMP 
BCS 
JMP 

& 

X.LF2  EQU 
DEC 
DEC 


SCROLLUP LDY 


#<X.CUR.OFF-$8001 ;ACK 
#<X.BELL-1 ;BEL 


#<X.BS-1 


0 


#<X.LF-1 


;BS 
;HT 
s LF 


#<X.VT-$8001 ;VT 
#<X.FF-$8001 ;FF 


;CR 


i'<X.S0-$8001 ;SO 
#<X.SI-$8001 ;SI 


0 


; DLE 


#<X.DC1-$8001 ;DCl 
#<X.DC2-$8001 ;DC2 


0 
0 


;DC3 
;DC4 


#<X.NAK-$8001 ;NAK 
#<SCROLLDN-$8001 ;SYN 
#<SCROLLUP-$8001 ;ETB 
i##<MOUSEOFF-$ 8001 
##<XEM-$8001 ;EM 
#<X.SUB-$8001 ;SUB 
i#<MOUSEON-$8001 
#<X.FS-$8001 ;FS 
#<X.GS-$8001 ;GS 


0 


;RS 


#<X.US-$8001 ;US 


on the value of X. 


#0 


SCROLLIT 


NEFEED: 


SCROLLIT TXA 


PHA 
STY 


TEMP1 


sdirection = down 
3=>go do scroll 


;SEE IF OFF BOTTOM 
;OFF THE END? 


3=>yes, scroll screen 
sexit thru VTABZ 


;back up to bottom 
sand fall into scroll 


;direction = up 
;save X 


ssave direction 
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SCROLLIT scrolls the screen either up or down, depending 
It scrolls within windows with even 
or odd edges for both 40 and 80 columns. 
windows down to 1 characters wide. 


It can scroll 


333 


CBF2:A5 21 28 LDA WNDWDTH sget width of screen window 
CBF4:48 29 PHA s;save original width 

CBF5:2C IF CO 30 BIT RD80VID sin 40 or 80 columns? 

CBF8:10 1C CCl6 31 BPL GETST1 3=>40, determine starting line 
CBFA:8) 01 CO 32 STA SET80COL j;make sure this is enabled 
CBFD:4A 33 LSR A sdivide by 2 for 80 column index 
CBFE:AA 34 TAX sand save 

CBFF:A5 20 35 LDA WNDLFT stest oddity of right edge 
CCO1:4A 36 LSR A sby rotating low bit into carry 
CCO2: B8 37 CLV ;V=0 if left edge even 

CCO3:90 03 ccos 38 BCC CHKRT s=>check right edge 

CCO5:2C 06 CB 39 BIT SEV1 ;V=l if left edge odd 

CC08:2A 40 CHKRT ROL A srestore WNDLFT 

CC09:45 21 41 EOR WNDWDTH s;get oddity of right edge 
CCOB:4A 42 LSR A ;C=1 if right edge even 

CCO0C:70 03 CCll 43 BVS GETST sif odd left, don't DEY 

CCOE:BO O01 CCl1 44 BCS GETST 3if even right, don't DEY 
CC10:CA 45 DEX 3if right edge odd, need one less 
CC11:86 21 46 GETST STX WNDWDTH ;save window width 

CC13:AD 1F CO 47 LDA RD80VID sN=l if 80 columns 

CC16:08 48 GETST1 PHP ssave N,Z,V 

CC17:A6 22 49 LDX WNDTOP sassume scroll from top 

CC19:98 50 TYA sup or down? 

CC1A:D0 03 CC1F 51 BNE SETDBAS ;=>up 

CC1C:A6 23 52 LDX WNDBTM sdown, start scrolling at bottom 
CC1E:CA 53 DEX ;really need one less 

CCIF: 54 * 

CC1F:8A 55 SETDBAS TXA ;sget current line 

CC20:20 03 CE 56 JSR VTABZ ;calculate base with window width 
CC23: 57 * 

CC23:A5 28 58 SCRLIN LDA BASL scurrent line is destination 
CC25:85 2A 59 STA BAS2L 

CC27:A5 29 60 LDA BASH 

CC29:85 2B 61 STA BAS2H 

CC2B: 62 * 

CC2B:AD 7B 07 63 LDA TEMP1 stest direction 

CC2E:FO 32 CC62 64 BEQ SCRLDN ;=>do the downer 

CC30:E8 65 INX sdo next line 

CC31:E4 23 66 CPX WNDBITM sdone yet? 

CC33:BO 32 CC67 67 BCS SCRLL3 3;=>yup, all done 

CC35:8A 68 SETSRC TXA ;set new line 

CC36:20 03 CE 69 JSR VTABZ s;get base for new current line 
CC39:A4 21 70 LDY WNDWDTH ;get width for scroll 

CC3B:28 71 PLP sget status for scroll 

CC3C:08 72 PHP sN=l if 80 columns 

CC3D:10 1E CCSD’ 73 BPL SKPRT s=>only do 40 columns 

CC3F:AD 55 CO 74 LDA TXTPAGE2 ;scroll aux page first (even bytes) 
CC42:98 75 TYA stest Y 

CC43:FO 07 CcCc4c' 76 BEQ SCRLFT sif Y=0, only scroll one byte 
CC45:Bl 28 77 SCRLEVEN LDA (BASL),Y 

CC47:91 2A 78 STA (BAS2L),Y 

CC49 :88 79 DEY 

CC4A:D0 F9 CC45 = 80 BNE SCRLEVEN ;do all but last even byte 
CC4C:70 04 Ccc52 #£«81 SCRLFT BVS' SKPLFT ;odd left edge, skip this byte 
334 Appendix I: Monitor ROM Listings 


CC4E: 
CC50: 
CC52: 
CC55: 
CCD7: 
CC59: 
CC5B: 
CCSD: 
CC5E: 
CC60: 
CC62: 
CC62: 
CC63: 
Cc65: 
CC67: 
CC67: 
CC68: 
CC69: 
CCOB: 
CCOE: 
CC71: 
CC72: 
CC73: 
CC74: 
Cc74: 
Cc74: 
CC74: 
CC77: 
CC/9: 
CC7A: 
CC7C: 
CC7F: 
CC82: 
CC84: 
CC86: 
CC8B8: 
CC8A: 
CC8B: 
CC8D: 
Cc90: 
CC90: 
CC90: 
Cc90: 
Cc90: 
CC93: 
CC96: 
CC96: 
CCc96: 
CC96: 
CC98: 
CC9A: 
CC9A: 
CC9A: 
: AC 


CC9A 


7B 


co 


cc 5D 


cc 59 
CC 23 


cc 35 


CC 
CD 


CC 


CC 82 
CE 
CC 


cc 7C 


CD 


cc 90 
CB 
CC 


CC 9D 


05 


LDA 
STA 
LDA 
LDY 
BCS 
LDA 
STA 
DEY 
BPL 
BML 


SKPLFT 


SCRLODD 


SKPRT 


* 


SCRLDN DEX 
CPX 
BPL 
* 


SCRLL3 PLP 
PLA 
STA 
JSR 
JSR 
PLA 
TAX 


RTS 
* 


(BASL),Y 
(BAS2L) ,Y 


TXTPAGE] ;now do main page (odd bytes) 


WNDWDTH ;srestore width 

SKPRT ;even right edge, skip this byte 

(BASL) ,Y 

(BAS2L),Y 

SCRLODD 

SCRLIN 3=> always scroll next line 
;do next line 

WNDTOP ;done yet 

SETSRC 3=>nope, not yet 
;pull status off stack 
;restore window width 

WNDWDTH 

X.SUB ;clear current line 

VTAB srestore original cursor line 
sand X 
sdone! !! 


* EXECUTE CLR TO EOS: 


* 


X.VT JSR 
LDA 
PHA 


BPL 


XeVTLOOP JSR 


JSR 


X.VINEXT INC 


LDA 
CMP 
BCC 
PLA 
STA 


JMP 
k 


X.GS ;CLEAR TO EOL 
CV sSAVE CV 
Xe-VTNEXT ;DO NEXT LINE (ALWAYS TAKEN) 
VTABZ ;set base address 
X.SUB ;CLEAR LINE 
CV 
CV 
WNDBTM ;OFF SCREEN? 
X.VTLOOP ;=>NO, KEEP GOING 
; RESTORE 
CV oy 
VTAB sreturn via VTAB (blech) 


* EXECUTE CLEAR: 


* 


X.FF EQU 
JSR 


JMP 
* 


* 


X-EM 
X.VT 


;HOME THE CURSOR 
;RETURN VIA CLREOS (UGH!) 


* EXECUTE CLEAR LINE 


#0 
X.GSEOLZ 


;start at left 
sand clear to end of line 


* EXECUTE CLEAR TO EOL: 


k 

X.SUB LDY 
BEO 

ke 

* 

X.GS LDY 
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OURCH sget CH 


380 


CC9D: 
CC9OF: 
CCAI1: 
CCA3: 
CCA6: 
CCA8: 
CCAA: 
CCAB: 
CCAD: 
CCAF: 
CCBO: 
CCBO: 
CCBO: 
CCBO: 
CCBO: 
CCB2: 
CCB4: 
CCB6: 
CCB8: 
CCBA: 
CCBD: 
CCBD: 
CCBD: 
CCBD: 
CCBF: 
CCCO: 
CCCl1: 
CCC2: 
CcCc3: 
CCC5: 
CCC6: 
CcG7: 
CCC8: 
CCCc9: 
CCCA: 
CCCC: 
CCCD: 
CCCF: 
CCD1: 
CCD2: 
CCD3: 
CCD5: 
CCD8: 
CCDA: 
CCDD: 
CCDE: 
CCEO: 
CCE2: 
CCE3: 
CCE4: 
CCE6: 
CCE8: 
CCE9: 
CCEA: 


336 


2A 


21 


cc 


co 


CO 


CCA8 


CCD2 
CCD2 


CCEO 


CCE6 


CCD5 


136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
L72 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 


X.GSEOLZ LDA INVFLG smask blank 


AND 
ORA 
BIT 
BMI 
CLR40 STA 
INY 
CPY 
BCC 


RTS 
k 


#$80 swith high bit of invflg 
#$20 smake it a blank 

RD80VID sis it 80 columns? 

CLR80 s=>yes do quick clear 
(BASL),Y 

WNDWDTH 

CLR40 


* Clear right half of screen for 40 to 80 
* screen conversion 


* 


CLRHALF STX 
LDX 
LDY 
LDA 
AND 
JMP 


BAS2L ;save X 

#SD8 sset horizontal counter 
#20 

INVFLG sset (inverse) blank 
#$A0 

CLR2 


* Clear to end of line for 80 columns 


CLR80 STX 
PHA 


CLRO PLA 


CLR2 BIT 


CLRI1 STA 


BAS2L ;save X 
sand blank 
;get count for CH 
;save for left edge check 
scount=WNDWDTH-Y-1 
WNDWDTH 
;save CH counter 
;div CH by 2 for half pages 


srestore original ch 
WNDLFT ;get starting page 


A 
CLRO 
CLRO 
;iff WNDLFT odd, starting byte odd 
;get blank 
CLRI ;starting page is 1 (default) 
TXTPAGE2 ;else do page 2 
(BASL),Y 
TXTPAGE]L j;now do page l 
CLR3 ;all done 
(BASL),Y 
sforward 2 columns 
snext ch 
CLR2 snot done yet 
BAS2L ;restore X 


;good exit condition 
sand return 
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190 * EXECUTE '40COL MODE': 


191 * 
CCEA 192 X.DCl EQU * 
FB 04 193 LDA MODE sdon*t convert if Pascal 
4D 
194 BMI X.DCIRTS ;=>it's Pascal 
31 CD 195 X.DC1A JSR SETTOP sset top of window (0 or 20) 
1F CO 196 BIT RD80VID sare we in 80 columns? 
12 CDO9 197 BPL X.DCI1B 3=>no, no convert needed 
91 CD 198 JSR SCRN84 selse convert 80 to 40 
OD cDdO9 199 BCC X.DCIB ;=>always set new window 
200 * 
201 * Set 80 column mode 
202 * 
CCFC 203 X.DC2 EQU * 
90 CA 204 JSR TESTCARD ;is there an 80 column card? 
3B CD3C 205 BNE X.DCIRTS' ;=>no, can't do this 
1F CO 206 BIT RD80VID sare we in 40 columns? 
03 CD09 207 BMI X.DCI1B 3=>no, mo convert needed 
C4 cn 208 JSR SCRN48 ;else convert 40 to 80 
209 * 
7B 05 210 X.DC1B LDA OURCH ;get cursor 
211 CLC ;since new window left = 0 
20 212 ADC WNDLFT ; NEWCH=OLDCH+OLDWNDLFT 
1F CO 213 BIT RD80VID sin 80 columns? 
06 CDIA 214 BMI X.DCIC s=>yes, CH is ok 
28 215 CMP #40 ;else if CH is too big, 
02 CDIA 216 BCC X.DCIC sset it to 39 
27 217 LDA #39 
7B 05 218 X.DC1C STA OURCH ;save new CH 
24 219 STA CH 
25 220 LDA CV ; base 
BA CA 221 JSR BASCALC 
1F CO 222 BIT RD80VID sin 80 columns? 
05 CD2E 223 BPL D040 s=>no, set forty column window 
224 * 
71 °CD 225 DO80 JSR FULL80 sset 80 column window 
03 CD31 226 BEQ SETTOP 3=Dalways branch 
227 * 
6D CD 228 DO40 JSR FULL40 sset 40 column window 
00 229 SETTOP LDA #0 sassume normal window 
1A CO 230 BIT RNDTEXT stext or mixed? 
02 CD3A 231 BMI DO4O0A s=>text, all ok 
14 232 LDA #20 
22 233 DO4OA STA WNDTOP ;set new top 
234 X.DCIRTS RTS 
235 * 
236 * EXECUTE MOUSE TEXT OFF 
237 * 
FB 04 238 MOUSEOFF LDA MODE 
01 239 ORA #M.MOUSE ;set mouse bit 
05 CD49 =240 BNE SMOUSF sto disable mouse chars 
241 * 


242 * EXECUTE MOUSE TEXT ON 
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CD44: 243 * 


CD44:AD FB 04 244 MOUSEON LDA MODE 

CD47:29 FE 245 AND #255-M.MOUSE ;clear mouse bit 
CD49:8D FB 04 246 SMOUSE STA MODE ;to enable mouse chars 
CD4C :60 247 RTS 

CD4D: 248 * 

CD4D: 249 * EXECUTE 'QUIT': 

CD4D: 250 * 

CD4D: CD4D 251 X.NAK EQU * 

CD4D:AD FB 04 252 LDA MODE sONLY VALID IN BASIC 
CD50:30 1A CD6C 253 BMI SKRTS signore if pascal 
CD52:20 2E CD 254 JSR D040 sforce 40 column window 
CD55:20 80 CD 255 JSR QUIT sdo stuff used by PR#O0 
CD58:20 64 CD 256 JSR SETCOUT] j;set output hook 
CD5B: 257 * 

CD5B:A9 FD 258 SETKEYIN LDA #<KEYIN  ;set input hook 
CD5D:85 39 259 STA KSWH 

CD5F:A9 1B 260 LDA #>KEYIN 

CD61:85 38 261 STA KSWL 

CD63 :60 262 RTS 

CD64: 263 * 

CD64:A9 FD 264 SETCOUT1 LDA #<COUT1 ;set output hook 
CD66:85 37 265 STA CSWH 

CD68:A9 FO 266 LDA #>COUT1 

CD6A:85 36 267 STA CSWL 

CD6C :60 268 SKRTS RTS 

CD6D: 269 * 

CD6D: 270 RREKRRKREAKERER ERK KKK AKERRERRERERIRERER ER 
CD6D: 271 * NAME : FULL4O 

CD6D: 272 * FUNCTION: SET FULL 40COL WINDOW 

CD6D: 273 * INPUT : NONE 

CD6D: 274 * OUTPUT : WINDOW PARAMETERS, A=0 

CD6D: 275 * VOLATILE: AC 

CD6D: 276 RERKKRKKKRREKRRERERKERERERERKK KR RK RK RAK 
CD6D: 277 * 

CD6D: CD6D 278 FULL40 EQU * 

CD6D:A9 28 279 LDA #40 ;set window width to 40 
CD6F:D0 02 CD73 280 BNE SAVWDTH 3=>(always taken) 
CD71: 281 * 

CD71: 282 HHRKKAKKKKHREKKEKREKRERRERERERREKE AKER 
CD71: 283 * NAME : FULL80 

CD71: 284 * FUNCTION: SET FULL 80COL WINDOW 

CD/1: 285 * INPUT : NONE 

CD71: 286 * OUTPUT : WINDOW PARAMETERS, A=0 

CD71: 287 *® VOLATILE: AC 

CD71: 2BQ KRKKKRKKRKKKRAAE RAK AKKERREKKKARKEKER ERK RRR 
CD71: 289 * 

CD71:A9 50 290 FULL80 LDA #80 sset full 80 column window 
CD73:85 21 291 SAVWDTH STA WNDWDTH 

CD/75:A9 18 292 LDA #24 

CD77:85 23 293 STA WNDBITM 

CD79:A9 00 294 LDA #0 

CD/B:85 22 295 STA WNDTOP 

CD7D:85 20 296 STA WNDLFT 
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CD/F 


:60 
CD80: 
CD80: 
CD80: 
CD80: 
CD80: 
CD83: 
CD85: 
CD88: 
CD8B: 
CD8N: 
CD90: 
CD91: 
CD91: 
CD91: 
CD91: 
CD91: 
CD91: 
CD92: 
CD93: 
CD95: 
CD98: 
CD99: 
CD9C: 
CD9E: 
CDAO: 
CDA1: 
CDA2: 
CDA4: 
CDA7: 
CDA8: 
CDAA: 
CDAD: 
CDAF: 
CDB1: 
CDB2: 
CDB4: 
CDB5: 
CDB?7: 
CDB9: 
CDBB: 
CDBE: 
CDC1: 
CDC4: 
CDC4: 
CDC5: 
CDC6: 
CDC8: 
CDCI: 
CDCC: 
CDCE: 
CDD1: 
CDD3: 
CDD5: 


CD&0 
co 
CD&8 
CC 
co 


04 


co 


CA 


CDA? 


CA 


co 


RTS 
* 


* QUIT is used by PR#0 to turn off everything 
* 


QUIT EQU * 
BIT RD80VID ;were we in 80 columns? 
BPL QUIT2 3=> not a chance 
JSR X.DCI1A sswitch to 40 columns 
QUIT2 STA CLRALTCHAR ;don't use lower case 
LDA #SFF *DESTROY THE 
STA MODE ; MODE BYTE 
RTS 
k 
* SCRN84 and SCRN48 convert screens between 40 & 80 cols. 
* WNDTOP must be set up to indicate the last line to 
* be done. All registers are trashed. 
x 
SCRN84 TXA ssave X 
PHA 
LDX #23 sstart at bottom of screen 
STA SET80COL j;allow page 2 access 
SCRI TXA scalc base for line 
JSR BASCALC 
LDY #39 sstart at right of screen 
SCR2 STY BAS2L ;save 40 index 
TYA sdiv by 2 for 80 column index 
LSR A 
BCS SCR3 
BIT TXTPAGE2 j;even column, do page 2 
SCR3 TAY sget 80 index 
LDA (BASL),Y ;get 80 char 
BIT TXTPAGE] j;restore pagel 
LDY BAS2L sget 40 index 
STA (BASL),Y 
DEY 
BPL SCR2 ;do next 40 byte 
DEX ;do next line 
BMI SCR4 ;=>done with setup 
CPX WNDTOP ;at top yet? 
BCS SCRI 
SCR4 STA CLR80COL ;clear 80STORE for 40 columns 
STA CLR80VID ;clear 80VID for 40 columns 
JMP SCRNRET ;calc base, restore X, exit 
* 
SCRN48 TXA ;save X 
PHA 
LDX #23 sstart at bottom of screen 
SCR5 TXA ;set base for current line 
JSR BASCALC 
LDY #0 sstart at left of screen 
STA SET80COL ;enable page2 store 
SCR6 LDA (BASL),Y ;get 40 column char 
SCR8 STY BAS2L s;save 40 column index 
PHA ;save char 
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389 


CDD6: 
CDD/7: 
CDD8: 
CDDA: 
CDDD: 
CDDE: 
CDDF: 
CDE1: 
CDE4: 
CDE6: 
CDE? : 
CDE9: 
CDEB: 


CDEE 


CDEF: 
CDF1: 
CDF3: 
CDF5: 
COF8: 
CDFB: 
CDFC: 
CDFD: 


:CA 


CDFE: 


CDFE: 
CEOO: 
CEO33 
CEO6: 
CEO8: 
CEOB: 
CEOD: 
CEOE: 
CEOF: 
CEl1l: 
CE13: 


CE14: 


CE14 


CE16: 
CE18: 
CEI1A: 
CEI1C: 
CELE: 


:C9 


CEILF: 
CELF: 
CEILF: 
CEI1F: 
CEIF: 
CELF: 
CEIF: 
CEILF: 
CEIF: 
CEILF: 
CEIF: 
CELF:AD FB 04 
CE22:29 10 


340 


03 
55 CO 


28 
54 CO 
2A 


28 
E6 
BO CC 


04 
22 
D3 
OD CO 
FE CD 


25 
FB 05 


CDDD 


CDD1 


CDF5 


CDC8 


BA CA 


20 
1F CO 
01 


28 
28 


El 
06 
FB 
02 
DF 


CEOE 


TYA sdiv 2 for 80 column index 
LSR A 
BCS SCR/7 ;save on pagel 
STA TXTPAGE2 
SCR7 TAY szet 80 column index 
PLA snow save character 
STA (BASL),Y 
STA TXTPAGEL 3;flip pagel 
LDY BAS2L srestore 40 column index 
INY ;move to the right 
CPY #40 sat right yet? 
BCC SCR6 3=>no, do next column 
JSR CLRHALF sclear half of screen 
DEX ;else do next line of screen 
BMI SCR9 ;=>done with top line 
CPX WNDTOP 3;at top yet? 
BCS SCR5 
SCRI STA SET80VID_ ;convert to 80 columns 
SCRNRET JSR VTAB ;update base 
PLA srestore X 
TAX 
RTS 
k 
VTAB LDA CV sget 80 column CV 
STA OURCV ;copy to OURCV 
VTABZ JSR BASCALC scalc base address 
LDA WNDLFT sand add window left to it 
BIT RD80VID sis it 80 columns? 
BPL VTAB40 ;swindow width ok 
LSR A selse divide width by 2 
VTAB40 CLC ;prepare to add 
ADC BASL sadd in window left 
STA BASL ;and update base 
VTABX RTS sand exit 
INCLUDE SUBS3 
UPSHFT CMP #SEl sis it lowercase? 
BCC UPSHFT2 ;=>nope 
CMP #SFB ;lowercase? 
BCS UPSHFT2 ;=>nope 
AND #SDF selse upshift 
UPSHFT2 RTS 
k 
KHKKKKKEKREKIKKEKRKRKERREAREKRREKKKKKREKKERRER 


* NAME 
* FUNCTION: 


* INPUT 

* OUTPUT 
* VOLATILE: 
* CALLS 


INVERT 
INVERT CHAR AT CH/CV 


: Unless Pascal and M.CURSOR=1 
: NOTHING 
: CHAR AT CH/CV INVERTED 


NOTHING 


: PICK, STORCHAR 


REKEKKKEAREEKREEKKERRKEREEERKKRKKEKRRKRKRRRKRKKKRE 


* 


PASINV LDA 
AND 


MODE scheck pascal cursor flag 
#M.CURSOR ;before displaying cursor 
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CE24: 
CE26: 
CE27: 
CE28: 
CE29: 
CE2C: 
CE2F: 
CE31: 
CE34: 
CE35: 
CE36: 
CE37: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE39: 
CE3B: 
CE3D: 
CE3F: 
CE3F: 
CE42: 
CE43: 
CE44: 
CE44: 
CE44: 
CE44: 
CE44: 
CE44: 
CE44: 
CE44: 
CE44; 
CE44: 
CE46: 
CE49: 
CE4B: 
CE4E: 
CE50: 
CE51: 
CE53: 
CE54: 
CE56: 
CE59: 
CE5A: 
CE5B: 
CE5C: 


11 


7B 05 
44 CE 


70 CE 


a2 
02 
7F 


70 CE 


CE37 


CE38 


CE3F 


CE3F 


CE64 


INVERT 


INVX 


BNE 
PHA 
TYA 
PHA 
LDY 
JSR 
EOR 
JSR 
PLA 
TAY 
PLA 
RTS 


INVX 


OURCH 
PICK 
#$80 
STORIT 


3=>cursor off, don't invert 
;save AC 
; AND Y 


;GET CH 

;GET CHARACTER 

;FLIP INVERSE/ NORMAL 
; ONTO SCREEN 
;RESTORE Y 

; AND AC 


HREKKEKKEKKEKEKEKEERERREKREREKRERRERKEERERRRERKK 


: STORCHAR 
STORE A CHAR ON SCREEN 
: AC=CHAR 
>: Y=CH POSITION 
: CHAR ON SCREEN 


* NAME 
FUNCTI 
INPUT 


VOLATI 


* 
x 
* 
* OUTPUT 
* 
* CALLS 


* 


ON: 


LE: 


NOTHING 


: SCREENIT 
KEKKKKREKREREREKREREKKKEKREKEKEEKE AREER KK 


STORCHAR EQU * 


STOR2 


SEV 


PHA 
BIT 
BMI 
AND 
EQU 
JSR 
PLA 
RTS 


INVFLG 
STOR2 
#S7F 

* 


STORIT 


;SAVE AC 

sNORMAL OR INVERSE? 
;=>NORMAL 

sinverse it 


;=>do it!! 
s;RESTORE AC 


REEKEKREREKEKEEKRERKEEREREREEKKRKRK KKK KKK 


: PICK 
GET A CHAR FROM SCREEN 
: Y=CH POSITION 

: AC=CHARACTER 


* NAME 
* FUNCTI 
* INPUT 
* OUTPUT 
* VOLATI 
* CALLS 


* 
PICK 


PICK] 


ON: 


LE: 


NOTHING 


: SCREENIT 
KHKKKKKRKKKKEKEK EKER ERE KER RERAEKKK KEREKRERE KE 


(BASL),Y 
RD8OVID 
PICK3 
SET80COL 
BAS2L 


WNDLFT 
A 

PICKl 
TXTPAGE2 


sget 40 column character 
380 columns? 

s=>no, do text shift 
sforce 80STORE for 80 columns 
;temp store for position 
;divide CH by two 

;C=1 if char in main RAM 
;get low bit into carry 
3=>store in main memory 
;else switch in page 2 
sfor odd left, aux bytes 
sdivide position by 2 
sand use carry as 

;page indicator 
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34] 


CE5D: 
CE5F: 
CE62: 
CE64: 
CE67: 
CE69: 
CE6B: 
CE6D: 
CE6F: 
CE/0: 
CE/0: 
CE/70: 
CE/0: 
CE70: 
CE/0: 
CE/0: 
CE/0: 
CE/0: 
CE/0: 
CE70: 
CE/70: 
CE/0: 
CE71: 
CE73: 
CE75: 
CE78: 
CE79: 
CE7A: 
CE/B: 
CE7D: 
CE80: 
CE82: 
CE84: 
CE87: 
CE89: 
CE8B: 
CE8B: 
CE8E: 
CE90: 
CE93: 
CE94: 
CE96: 
CE97: 
CE99: 
CEQA: 
CE9C: 
CE9F: 
CEAO: 
CEAIL: 
CEA2: 
CEA3: 
CEA4: 
CEA6: 
CEA9: 


342 


04 
55 


28 


2A 


co 


CE8B 


CEAO 


83 


94 
95 


PICK2 LDA (BASL),Y ;get that char 
BIT TXTPAGE] ;flip to page 1 
LDY BAS2L 
PICK3 BIT ALTCHARSET ;only allow mouse text 
BPL PICK4 sif alternate character set 
CMP #$20 
BCS PICK4 
ORA #$40 
PICK4 RTS 
* 
HEKKKKAKIKREKEREREKRKEEEEREKKREARKAK RAKE KKEKK 
* NAME : STORIT 
* FUNCTION: STORE CHAR 
* INPUT : AC=char for store 
* Z=high bit of char 
*% : Y=CH POSITION 
* OUTPUT : AC=CHAR (PICK) 
* VOLATILE: NOTHING 
* CALLS : NOTHING 
KAKKKKEKAKRERKKRKKEKKEKREKEKREEKKKKKKKKRKKKKKKE 
& 
STORIT PHA ;save char 
AND #SFF ;if high bit set... 
BMI STORE] ;=>not mouse text 
LDA MODE sis mouse text enabled? 
ROR A suse carry as flag 
PLA sand restore char 
PHA sneed to save it too 
BCC STORE] 
BIT ALTCHARSET ;only do mouse text if 
BPL STOREIL salt char set switched in 
EOR #$40 sdo mouse shift 
BIT HEX60 ;is it in proper range? 
BEQ STORE] s=>yes, leave it 
EOR #$40 selse shift it back 
* 
STORE] BIT RD80OVID 380 columns? 
BPL STOR4O ;=>no, 40 columns 
STA SET80COL_ ;force 80STORE for 80 columns 
PHA ;save shifted character 
STY BAS2L ;temp storage 
TYA ;Zet position 
EOR WNDLFT ;C=1 if char in main RAM 
LSR A 
BCS STORE2 s=>yes, main RAM 
LDA TXTPAGE2 j;else flip in main RAM 
INY sdo this for odd left bytes 
STORE2 TYA ;get position 
LSR A ;and divide it by 2 
TAY 
STORIT2 PLA ;restore acc 
STA (BASL),Y ;save to screen 
LDA TXTPAGEL ;flip to page l 
LDY BAS2L 
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CEAB: 
:60 
CEAD: 

291 


CEAC 


CEAD 


CEAF: 
:60 
CEB1: 
CEBI: 
CEB1: 
CEB1: 
CEB1]: 
CEB1L: 
CEB1: 
CEB1: 
CEB1: 
CEB1: 
248 
298 
248 
: AC 
:20 
CEBA: 
CEBD: 
249 
:4C 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
248 
298 
748 
: AC 


CEBO 


CEB1 
CEB2 
CEB3 
CEB4 
CEB/ 


CEBF 
CEC1 


CEC4 
CEC5 
CEC6 
CEC7 


CECA: 
CECD: 
:20 
268 
:A8 
268 
:60 
CED4: 
CED4: 
CED4: 
CED4: 
CED4: 
CED4: 
CED4: 
CED4: 


CECD 
CEDO 
CEDI 
CED2 
CED3 


68 


68 


8D 
29 


AD 


28 


7B 05 
44 CE 
7B 06 
80 
AB 
CD CE 


7B 05 
7B 06 


70 CE 


CEBL 


CEC4 


CECD 


128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 


PLA ;restore true Acc 
HEX60 RTS sand exit 
os 
STOR4O STA (BASL),Y j;quick 40 column store 
PLA ;restore real char 
RTS 
REKKKEKKKEREKRAEKRRERERERERKRKKKK RKKKKKKEKK 
* NAME : ESCON 
* FUNCTION: TURN ON 'ESCAPE' CURSOR 
* INPUT : NONE 
* OUTPUT "CHAR'=ORIGINAL CHAR 
* VOLATELE: NOTHING 
* CALLS : PICK,STORCHAR 
KREKKKAKEKREKAEKKRERERERKEEEEKKRKKKK KK KKK KKK 
k 
ESCON EQU * 
PHA ;SAVE AC 
TYA ; AND Y 
PHA 
LDY OURCH ;GET CH 
JSR PICK sGET ORIGINAL CHARACTER 
STA CHAR ; AND REMEMBER FOR ESCOFF 
AND #$80 ;SAVE NORMAL/INVERSE BIT 
EOR #SAB sMAKE IT AN INVERSE '+' 
JMP ESCRET sRETURN VIA SIMILAR CODE 
KREKKKKEKKKKKKKKKKKKKKKKKKKKK KKK KKK KKK 
* NAME : ESCOFF 
* FUNCTION: TURN OFF 'ESCAPE' CURSOR 
* INPUT "CHAR'=ORIGINAL CHAR 
* OUTPUT : NONE 
* VOLATILE: NOTHING 
* CALLS : STORCHAR 
KHKKKKKKKKKKKREKEKRERERERERAKKKKKKRKKKKRKKKE 
* 
ESCOFF EQU * 
PHA ;SAVE AC 
TYA ; AND Y 
PHA 
LDY OURCH ;GET CH 
LDA CHAR ;GET ORIGINAL CHARACTER 
ESCRET EQU #* ;USED BY ESCON 
JSR STORIT ; EXACTLY AS IT WAS 
PLA ;RESTORE Y 
TAY 
PLA - AND AC 
RTS 
PTET ITTTTITITILTTTLILLIE LTT TT LLL Ee Le LLL. tt.) 
* NAME : PSETUP 
* FUNCTION: SETUP ZP FOR PASCAL 
* INPUT : NONE 
* OUTPUT : NONE 
* VOLATILE: AC 
* CALLS : NOTHING 
KKKEKKKEKKEEKIEREEKEEKKKKKKKK KKK KKK 
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CED4: 
CED4: 
CED4: 
CED/7: 
CED9: 
CEDB: 
CEDB: 
CEDE: 
CEEO: 
CEE2: 
CEE4: 
CEE4: 
CEE4: 
CEE/7: 
CEE9: 
CEEC: 
CEEE: 
CEF1: 
CEF3: 
CEF4: 
CEF4: 
CEF4: 
CEF4: 
CEF4: 
CEF4: 
CEF4: 
CEF4: 
CEF4: 
CEF/7: 
CEF9: 
CEFB: 
CEFE: 
CFO0: 
CFO2: 
CFOS: 
CFO7: 
CFO9: 
CFOC: 
CFOF: 
CF1l2: 
CF14: 
CF16: 
CFl?7: 
CFIA: 
CF1D: 
CFIF: 
CF21: 
CF23: 
CF25: 
CF27: 
CF29: 
CF2A: 
CF2C: 
CF2E: 
CF30: 
CF33: 
CF36: 


344 


CED4 
cD 


04 


CEE4 


CEE4 


07 


07 


05 


co 
CF36 


FB 
CF36 


co 
CFO9 


FB 

co 

FB 
CF1/7 


co 
co 


CF25 


CF25 
CO 
co 


* 


PSETUP EQU * 
JSR FULL80 ‘SET FULL 80COL WINDOW 
1880 LDA #255 
STA INVFLG ; ASSUME NORMAL MODE 
x 
LDA MODE 
AND #M.VMODE 
BEQ PSETUPRET ;=>IT'S NORMAL 
LSR INVFLG ;MAKE IT INVERSE 
* 
PSETUPRET EQU * 
LDA OLDBASL ;SET UP BASE ADDRESS 
STA BASL 
LDA OLDBASH 
STA BASH 
LDA OURCV ;sget user's cursor vertical 
STA CV sand set it up 


RTS 
KKEKKKEKRKEKEKKEREKEERERERREKEEEKEKK KEERKEKE 


2 
* COPYROM is called when the video firmware is 
* initialized. If the language card is switched 


* in for reading, it copies the F8 ROM to the 
* language card and restores the state of the 
* language card. 
* 
COPYROM BIT RDLCRAM sis the LC switched in? 
BPL ROMOK 3=>no, do nothing 
LDA #GOODF8 syes, check S$F8 RAM 
CMP F8VERSION ;does it match? 
BEQ ROMOK ;=> assum ROM is there 
LDX #3 sindicate bank 2, RAM write enabled 
BIT RDLCBNK2 ;is it bank 2? 
BMI BANK2 s=Pyes, we were right 
LDX #5SB sno, bank 1, RAM write enabled 
BANK2 STA F8VERSION ;write to see if LC is 
BIT $c080 swrite protected (read RAM) 
LDA F8VERSION ;did it change? 
CMP #GOODF8 
BEQ WRTENBL 3;=>yes, write enabled 
INX selse indicate write protect 
WRTENBL BIT $C081 ;read ROM, write RAM 
BIT $C081 stwice is nice 
LDY #$0 snow copy ROM to RAM 
LDA #SF8 
STA CSWH shooks set later 
STY CSWL 


COPYROM2 LDA (CSWL),Y j;get a byte 


STA (CSWL),Y ;and move it 
INY 
BNE COPYROM2 
INC CSWH snext page 
BNE COPYROM2 ;finish copy 
LDA $C080,x sread RAM 
LDA $C080,x 
ROMOK RTS ;done with ROM copy 
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0000 


0001 


0000 


F800 
C100 
C300 
C800 


0001 


F800 
2000 


0000 
0001 
00 20 
0021 
00 22 
00 23 
00 24 
00 25 
00 26 
00 27 
00 28 


TEST 


IRQTEST 


F80RG 
IOADR 
C1ORG 
C30RG 
C80RG 


F80ORG 
C1ORG 
C30RG 
C80RG 


EQU 


LST 
EQU 
MSB 
DO 

EQU 
EQU 
EQU 
EQU 
EQU 


0 


On,A,V 


l 

ON 
TEST 
$1800 
$2000 
$2100 
$2300 
$2800 


ELSE 


EQU 
EQU 
EQU 
EQU 
FIN 


S$ F800 
$c100 
$c300 
$c800 


;SET THEM HIBITS 


;For setting PR# hooks 


REKEKEEERKEKEKEERERKEERREREKKRKRKEKRERE 


APPLE 


+ + & HF HF HF He HF HF He HF HF HF FF 


II 


MONITOR II 


ALL RIGHTS RESERVED 


Se WOZNIAK 
A. BAUM 
JOHN A 
R. AURICCHIO 
E. BEERNINK 


APPLE2E EQU 1 
* 


COPYRIGHT 1978, 1981, 1984 BY 
APPLE COMPUTER, INC. 


1977 
1977 
1978 
1981 
1984 


;COND ASSM/RRAO981 


RKERKEKKKKEEKKKEREKKKEEKKREKERRKKRAKER 


ORG 
OBJ 


F80RG 
$2000 


REKKEEKEKRKEKEKERKEKRKEKK RR RRRK 


* 


* Zero Page Equates 


* 
LOCO 


EQU 
EQU 
EQU 


| EQU 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


$00 
$01 
$20 
$21 
$22 
$23 
$24 
$25 
$26 
$27 
$28 


;vector for autost from disk 


;left edge of text window 
swidth of text window 

;top of text window 
sbottomtl of text window 
;cursor horizontal position 
;cursor vertical position 
;lo-res graphics base addr. 


stext base address 
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F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
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0029 
002A 
002B 
002C 
002C 
002D 
002D 
002E 
O002E 
002E 
002F 
002F 
0030 
0031 
0032 
0033 
0034 
0035 
0036 
0037 
0038 
0039 
003A 
003B 
003C 
003D 
O003E 
003F 
0040 
0041 
0042 
0043 
0044 
0044 
0045 
0045 
0046 
0047 
0048 
0049 
OO4E 
OO4F 


0095 


0200 


03F0 
O3F2 
O3F4 
O3F5 
O3F8 


BASH 
BAS2L 
BAS2H 
H2 
LMNEM 
V2 
RMNEM 
MASK 
CHKSUM 
FORMAT 
LASTIN 
LENGTH 
COLOR 
MODE 
INVFLG 
PROMPT 
YSAV 
YSAV1 
CSWL 
CSWH 
KSWL 
KSWH 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EOU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
FOU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


EQU 


EQU 


$29 
S$2A 
$2B 
$2C 
$2C 
$2D 
$2D 
S2E 
S2E 
S2E 
$2F 
S2F 
$30 
$31 
$32 
$33 
$34 
$35 
$36 
$37 
$38 
$39 
S3A 
S3B 
$3C 
$3D 
S3E 
S3F 
$40 
$41 
$42 
$43 
S44 
$44 
$45 
$45 
$46 
$47 
$48 
$49 
$4E 
S4F 


$95 


$0200 


* Page 3 vectors 


* 


BRKV 
SOFTEV 
PWREDUP 
AMPERV 
USRADR 


EQU 
EQU 
EQU 
EQU 
EQU 


SO3F0O 
SO3F2 
SO3F4 
$O3F5 
S$O3F8 


;temp base for scrolling 


;temp for lo-res graphics 
;temp for mnemonic decoding 
stemp for lo-res graphics 
;temp for mnemonic decoding 
;color mask for lo-res gr. 
;temp for opcode decode 
;temp for opcode decode 
;temp for tape read csum 
;temp for opcode decode 
;color for lo-res graphics 
;Monitor mode 
snormal/inverse(/flash) 
;prompt character 

;position in Monitor command 
;temp for Y register 
;character output hook 


;character input hook 
;temp for program counter 


;Al-A5 are Monitor temps 


smachine state for break 


sAcc after break (destroys ASH) 
3X reg after break 

;Y reg after break 

;P reg after break 

;SP after break 

;random counter low 

;random counter high 


;CONTROL-U character 


;input buffer for GETLN 


svectors here after break 

svector for warm start 

sTHIS MUST = EOR #SA5 OF SOFTEV+1 
sAPPLESOFT & EXIT VECTOR 
;Applesoft USR function vector 
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F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F801: 
F802: 
F805: 
F806: 


03FB 
O3FE 


0400 
07F8 


0000 


c00O 


Cc00O 
c006 
c007 
C010 
COlLF 
C020 
C030 
C050 
co05 1 
C05 2 
C05 3 
C054 
c055 
C05 6 
c057 
C05 8 
c05 9 
CO5A 
CO5B 
cO5C 
c0O5 D 
CO5SE 
CO5F 
C060 
COG4 
C07 0 


C3FA 
C47 C 


C5@/7 
cS5SD1 
CS AA 


CFFF 
E000 
E0Q3 


IOADR 


KBD 


SLOTCXROM EQU $C006 


EQU 
EQU 


EQU 
EQU 


DO 
ELSE 
EQU 
FIN 


EQU 


SO3FB 
SO3FE 


$0400 
$07F8 


TEST 


$C000 


$c000 


INTCXROM EQU $C007 


KBDSTRB 
RD80VID 
TAPEOUT 


SPKR 
TXTCLR 
TXTSET 
MIXCLR 
MIXSET 
LOWSCR 
HISCR 
LORES 
HIRES 
SETANO 
CLRANO 
SETAN] 
CLRAN}L 
SETAN2 
CLRAN2 
SETAN3 
CLRAN3 
TAPEIN 
PADDLO 
PTRIG 
* 

IRQ 
ITROFIX 
* 


XHEADER 


XREAD 
WRITE2 
* 
CLRROM 
BASIC 
BASIC2 
* 


PLOT 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


EQU 
EQU 


EQU 
EQU 
EQU 


EQU 
EQU 
EQU 


LSR 
PHP 
JSR 
PLP 
LDA 


$c010 
SCOIF 
$c020 
$c030 
$c050 
$co051l 
$c052 
$c053 
$c054 
$c055 
$c056 
$C057 
$c058 
$c059 
SCO5A 
SCO5B 
S$CO5C 
$CO5D 
SCOSE 
SCOSF 
$C060 
$C064 
$c070 


sNMI vector 
;Maskable interrupt vector 


sfirst line of text screen 
scurrent user of $C8 space 


senable slots 1-7 
;swap out slots for firmware 


C30RG+SFA ;IRQ entry in $C3 page 
C30RG+$17C ;Restore state at IRQ 


C30RG+$267 
C30RG+S$2D1 
C30RG+S2AA 


SCFFF 
SEO00 
S$E003 


A 


GBASC ALC 


#S0F 
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;Y-COORD/2 

; SAVE LSB IN CARRY 

;CALC BASE ADR IN GBASL,H 
;RESTORE LSB FROM CARRY 
;MASK SOF IF EVEN 
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F808: 
F80A: 
F80C: 
F80E: 
F810: 
F812: 
F814: 
F816: 
F818: 
F819: 
F819: 
F81C: 
F81E: 
F820: 
F821: 
F824: 
F826: 
F828: 
F829: 
F82C: 
F82D: 
F82F: 
F831: 
F832: 
F832: 
F834: 
F836: 
F838: 
F83A: 
F83A: 
F83C: 
F83E: 
F840: 
F843: 
F844; 
F846: 
F847: 
F847: 
F848: 
F849: 
F84B: 
F84D: 
F84F:; 
F850: 
F852: 
F854: 
F856: 
F858: 
F859: 
F385A: 
F85C: 
F85E: 
F85F: 
F85F: 
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F8 


F8 


F8 


F8 


F80C 


F831 


F81C 


F826 


F838 


F83C 


F856 


146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 


RTMASK 
PLOT] 


*& 


HLINE 
HLINE] 


VLINEZ 
VLINE 


RTS1 
* 


CLRSCR 


CLRTOP 
CLRSC2 


9 


CLRSC3 


& 


GBASCALC PHA 


GBCALC 


k 
NXTCOL 


BCC 
ADC 
STA 
LDA 
EOR 
AND 
EOR 
STA 
RTS 


JSR 
CPY 
BCS 
INY 
JSR 
BCC 
ADC 
PHA 
JSR 
PLA 
CMP 
BCC 
RTS 


LDY 
BNE 
LDY 
STY 


LDY 
LDA 
STA 
JSR 
DEY 
BPL 
RTS 


LSR 
AND 
ORA 
STA 


STA 
ASL 
ASL 
ORA 
STA 
RTS 


LDA 


RTMASK 


#SEO 
MASK 


(GBASL) ,Y 


COLOR 
MASK 


(GBASL),Y 
(GBASL),Y 


;MASK SFO IF ODD 


; DATA 
; XOR COLOR 
; AND MASK 
; XOR DATA 
; TO DATA 


;PLOT SQUARE 

; DONE? 

; YES, RETURN 

; NO, INCR INDEX (X-COORD) 
;PLOT NEXT SQUARE 

;ALWAYS TAKEN 

;NEXT Y—COORD 

; SAVE ON STACK 

; PLOT SQUARE 


; DONE? 
; NO, LOOP. 


sMAX Y, FULL SCRN CLR 

sALWAYS TAKEN 

“MAX Y, TOP SCRN CLR 

;STORE AS BOTTOM COORD 
FOR VLINE CALLS 

sRIGHTMOST X-COORD (COLUMN) 

sTOP COORD FOR VLINE CALLS 

*CLEAR COLOR (BLACK) 

sDRAW VLINE 

sNEXT LEFTMOST X-COORD 

;LOOP UNTIL DONE. 


;FOR INPUT OODEFGH 


;GENERATE GBASH=000001FG 


:AND GBASL=HDEDEO00 


; INCREMENT COLOR BY 3 
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F861: 
F862: 
F864: 
F866: 
F868: 
F869: 
F86A: 
F86B: 
F86C: 
F86E: 
F870: 
F871: 
F871: 
F872: 
F873: 
F876: 
F878: 
F879: 
F87B: 
F87C: 
F87D: 
F87E: 
F87F: 
F881: 
F882: 
F882: 
F884: 
F886: 
F889: 
F88C: 
F88E: 
F88F: 
F890: 
F892: 
F893: 
F895: 
F897: 
F899: 
F8 9B: 
F89C: 
F89D: 
F8A0: 
F8A3: 
F8A5: 
F8A7: 
F8A9: 
F8AA: 
F8AD: 
F8AF: 
F8AF: 
F8AF: 
F8AF: 
F8AF: 
F8AF: 


30 
30 


47 
26 


04 


OF 


F8 


F87 F 


FD 
F9 


F89B 


F8A5 


F8A5 


F9 


CLC 
ADC #$03 
SETCOL AND #SOF ;SETS COLOR=17*A MOD 16 
STA COLOR 
ASL A ;BOTH HALF BYTES OF COLOR EQUAL 
ASL A 
ASL A 
ASL A 
ORA COLOR 
STA COLOR 
RTS 
* 
SCRN LSR A ;READ SCREEN Y-COORD/2 
PHP ;SAVE LSB (CARRY) 
JSR GBASCALC ;CALC BASE ADDRESS 
LDA (GBASL),Y ;GET BYTE 
PLP ;RESTORE LSB FROM CARRY 
SCRN2 BCC RTMSKZ ;LF EVEN, USE LO H 
LSR A 
LSR A 
LSR A ;SHIFT HIGH HALF BYTE DOWN 
LSR A 
RTMSKZ AND #SOF ;MASK 4-BITS 
RTS 
x 
INSDS1] LDX PCL ;PRINT PCL,H 
LDY PCH 
JSR PRYX2 
JSR PRBLNK ; FOLLOWED BY A BLANK 
LDA (PCL,X) ;GET OPCODE 
INSDS2 TAY 
LSR A ;EVEN/ODD TEST 
BCC IEVEN 
ROR A ;BIT 1 TEST 
BCS ERR ;XXXXXX11 INVALID OP 
CMP #SA2 
BEQ ERR ;OPCODE $89 INVALID 
AND #$87 ;MASK BITS 
IEVEN LSR A ;LSB INTO CARRY FOR L/R TEST 
TAX 
LDA FMT1,X ;GET FORMAT INDEX BYTE 
JSR SCRN2 ;R/L H-BYTE ON CARRY 
BNE GETFMT 
ERR LDY #$80 ; SUBSTITUTE $80 FOR INVALID OPS 
LDA #$00 ;SET PRINT FORMAT INDEX TO 0 
GETFMT TAX 
LDA FMT2,X ; INDEX INTO PRINT FORMAT TABLE 
STA FORMAT ; SAVE FOR ADR FIELD FORMATTING 
; (O=1 BYTE, 1=2 BYTE, 2=3 BYTE) 
x 
* Move code to Cl-C2 because the code 
* that tests for ROM in slot 3 must be in 
* the F8 ROM. 
* 
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F8AF : AA 
F8B0 :84 
F8B2:A0 
F8B4 :4C 
F8B7: 

F8B7: 

F8B/7: 

F8B7: 

F8B/7: 

F8B/7: 

F8B/7: 

F8B7 :8D 
F8BA:A2 
F8BC: BD 
F8BF:DD 
F8C2 : DO 
F8C4:CA 
F8C5:CA 
F8C6:10 
F8C8 :88 
F8C9:DO 
F8CB:8D 
F8CE:60 
F8CF: 

F8CF:EA 
F8D0: 

F8D0:20 
F8D3 :48 
F8D4 : Bl 
F8D6 : 20 
F8D9:A2 
F8DB:20 
F8DE:C4 
F8E0 :C8 
F8E1 :90 
F8E3:A2 
F8E5:CO 
F8E7 :90 
F8E9 :68 
F8EA: A8 
F8EB: B9 
F8EE :85 
F8FO: B9 
F8F3:85 
F8F5:A9 
F8F7 : AO 
F8F9:06 
F8FB:26 
F8FD:2A 
F8FE:88 
F8FF :DO 
F901 :69 
F903:20 
F906:CA 


300 


2A 
10 
B4 


EF 


82 


3A 
DA 
01 
4A 
2F 


Fl 
03 
04 
F2 


co 
2C 
00 
2D 
00 
05 
2D 
2C 


F8 
BF 
ED 


FB 


F8D4 


F8DB 


F9 


FA 


FD 


F8F9 


+e + + H 


x 


TSTROM 
TSTROMO 
TSTROM1 


XTST 


INSTDSP 


PRNTOP 


PRNT BL 


PRMNI1 


PRMN2 


TAX 
STY 
LDY 
JMP 


ROM/bus is 


STA 
LDX 
LDA 
CMP 
BNE 
DEX 
DEX 
BPL 
DEY 
BNE 
STA 
RTS 


NOP 


BAS2L 
#$10 
GOTOCX 


ssave ACC in X 
;and Y in scrolling temp 


scall = finish mnemonics 
soff to C100 


Test slot 3 for a card containing ROM. 

If there is one, we'll not switch in our internal 
slot 3 firmware (for 80 columns). 

On entry Y 


has a high value like $F2, so the 
read a bunch of times 


SLOTCXROM 


#2 
$c305,X 


CLREOL, X 


XTST 


TSTROM1] 


TSTROMO 


INTCXROM 


INSDS1 


(PCL),Y 
PRBYTE 
#$01 
PRBL2 
LENGTH 


PRNTOP 
#$03 
#$04 
PRNTBL 


MNEML ,Y 
LMNEM 
MNEMR, Y 
RMNEM 
#500 
#S05 
RMNEM 
LMNEM 

A 


PRMN2 
#SBF 
COUT 


;swap in slots 

;check 2 ID bytes 

sat C305 and $C307 

swith two bytes that are same 


scheck next ID byte 


;if ROM ok, exit with BEQ 
;swap internal ROM 

sand return there 

;line things up 

;GEN FMT, LEN BYTES 

;SAVE MNEMONIC TABLE INDEX 
;PRINT 2 BLANKS 


;PRINT INST (1-3 BYTES) 
;IN A 12 CHR FIELD 


;CHAR COUNT FOR MNEMONIC INDEX 


;RECOVER MNEMONIC INDEX 


;FETCH 3-CHAR MNEMONIC 
; (PACKED INTO 2-BYTES) 


;SHIFT 5 BITS OF CHARACTER INTO A 


; (CLEARS CARRY) 


sADD "2" OFFSET 
-OUTPUT A CHAR OF MNEM 
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F907:DO EC F8F5 308 BNE PRMNI 

F909:20 48 F9 309 JSR PRBLNK ;OUTPUT 3 BLANKS 
F9OC:A4 2F 310 LDY LENGTH 

FIOE:A2 06 311 LDX #506 ;CNT FOR 6 FORMAT BITS 
F910:EQ 03 312 PRADRI CPX #$03 

F912:FO 1C F930 313 BEQ PRADRS5 ;1F X=3 THEN ADDR. 
F914:06 2E 314 PRADR2 ASL FORMAT 

F916:90 OE F926 315 BCC PRADR3 

F918:BD B3 F9 316 LDA CHAR1-1,X 

F91B:20 ED FD 317 JSR COUT 

F91E:BD B9 F9 318 LDA CHAR2-1,X 

F921:FO 03 F926 319 BEQ PRADR3 

F923:20 ED FD 320 JSR COUT 

F926:CA 321 PRADR3 DEX 

F927:DO E7 F91O 322 BNE PRADRI 

F929:60 323 RTS 

F92A:88 324 PRADR4 )NEY 

F92B:30 E/7 F914 325 BMI PRADR2 

F92D:20 DA FD 326 JSR PRBYTE 

F930:A5 2E 327 PRADR5 LDA FORMAT 

F932:C9 E8 328 CMP #SE8 ;HANDLE REL ADR MODE 
F934:Bl 3A 329 LDA (PCL),Y >SPECIAL (PRINT TARGET, 
F936:90 F2 FIZA 330 BCC PRADR4 ; NOT OFFSET) 

F938:20 56 F9 331 RELADR JSR  PCADJ3 

F93B:AA 332 TAX ;PCL,PCH+OFFSET+1 TO A,Y 
F93C:E8 333 INX 

F93D:D0 Ol F940 334 BNE PRNTYX ;+l1 TO Y,X 

F93F:C8 335 INY 

F940:98 336 PRNTYX TYA 

F941:20 DA FD 337 PRNTAX JSR PRBYTE sOUTPUT TARGET ADR 
F944:8A 338 PRNTX TXA ; OF BRANCH AND RETURN 
F945:4C DA FD 339 JMP PRBYTE 

F948: 340 * 

F948:A2 03 341 PRBLNK LDX #$03 ; BLANK COUNT 

F94A:A9 AO 342 PRBL2 LDA #SAO ;LOAD A SPACE 

F94C:20 ED FD 343 PRBL3 JSR COUT s;OUTPUT A BLANK 
FO4F:CA 344 DEX 

F950:DO F8 F9O4A 345 BNE PRBL2 ;LOOP UNTIL COUNT=0 
F952 :60 346 RTS 

F953: 347 * 

F953:38 348 PCADJ SEC -O=1 BYTE, 1=2 BYTE, 
F954:A5 2F 349 PCADJ2 LDA LENGTH ; 2=3 BYTE 

F956:A4 3B 350 PCADJ3 LDY PCH 

F958:AA 351 TAX ;TEST DISPLACEMENT SIGN 
F959:10 Ol F95C 352 BPL PCADJ4 ; (FOR REL BRANCH) 
F95B:88 353 DEY ;EXTEND NEG BY DECR PCH 
F95C:65 3A 354 PCADJ4 ADC PCL 

F95E:90 Ol F961 355 BCC RTS2 ;PCL+LENGTH(OR DISPL)+1l TO A 
F960:C8 356 INY ; CARRY INTO Y (PCH) 
F961 :60 357 RTS2 RTS 

F962: 358 ; 

F962: 359 ; FMT1 BYTES: XXXXXXYO INSTRS 

F962: 360 ; IF Y=0 THEN LEFT HALF BYTE 

F962: 361 ; IF Y=1 THEN RIGHT HALF BYTE 
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F962: 
F962: 
F962: 
F963: 
F964: 
F965: 
F966: 
F967: 
F968: 
F969: 
F96A: 
F96B: 
F96C: 
F96D: 
F96E: 
F96F: 
F970: 
F971: 
F972: 
F973: 
F974: 
F975: 
F976: 
F977: 
F978: 
F979: 
F97A: 
F97B: 
F97C: 
F97D: 
FO7E: 
FO7F: 
F980: 
F981: 
F982: 
F983: 
F984: 
F985: 
F986: 
F987: 
F988: 
F989: 
F98A: 
F98B: 
F98C: 
F98D: 
F98E: 
F98F: 
F990: 
F991: 
F992: 
F993: 
F994: 
F995: 


362 ; 
363 ; 
364 FMT1l 
365 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


(X=INDEX) 
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DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


SOD 
$80 
$04 
$90 
$01 
$22 
S44 
$33 
SOD 
$80 
$04 
$90 
$26 
$31 
$87 
S9A 


; ZZXXXY01 INSTR'S 


’ 
FMT2 


CHARI] 


CHAR2 


MNEML 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


$00 ERR 

$21 ; [IMM 

$81 : Z-PAGE 
$82 ; ABS 

$00 > IMPLIED 
$00 ; ACCUMULATOR 
$59 ; (ZPAG ,X) 
S4D ;(ZPAG),Y 
$91 ;ZPAG ,X 
$92 ;ABS,X 
$86 ;ABS ,Y 
S4A *( ABS) 
$85 ;ZPAG,Y 
S9D *RELATIVE 
SAC Ft 

SAI ae 

SAC et 

$A3 oti 

SA8 ae eg 

SA4 a 

$D9 ety" 

$00 

SD8 ony ' 

SA4 etS! 

SA4 atc! 

$00 

S$1C 

S8A 

$1C 

$23 

$5D 

$8B 

S1B 

SAl 

$9D 
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F9C9: 
F9CA: 
F9CB: 
F9CC: 
F9ICD: 
F9CE: 
F9OCF: 
F9DO: 
F9D1L: 
F9D2: 
F9D3: 
F9D4: 
F9D5: 
F9D6: 
F9D7: 
F9D8: 
F9D9: 
F9ODA: 
FODB: 
F9ODC: 
FODD: 
FODE: 
FODF: 
F9EO: 
F9EL: 
F9E2: 
F9E3: 
F9E4; 
F9ES: 
F9E6: 
F9E7: 
FOES: 
F9E9: 
F9EA: 
FOEB: 
F9EC: 
F9ED: 
F9OEE: 
F9OEF: 
F9FO: 
F9OF1: 
FOF2: 
F9F3: 
FOF4: 
FOF5: 
F9F6: 
F9OF/7: 
F9OF8: 
FOF9: 
FOFA: 
F9OFB: 
F9OFC: 
F9FD: 
FOFE: 


304 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


S8A 
$1D 
$23 
$9D 
S8B 
S$1D 
SAl 
$00 
$29 
$19 
SAE 
$69 
SA8 
$19 
$23 
$24 
$53 
S1B 
$23 
$24 
$53 
$19 
SAl 
$00 
SIA 
SSB 
S5B 
SA5 
$69 
$24 
$24 
SAE 
SAE 
SA8 
SAD 
$29 
$00 
$7C 
$00 
$15 
$9C 
S6D 
S9C 
SA5 
$69 
$29 
$53 
$84 
$13 
$34 
$11 
SA5 
$69 
$23 


; (A) 


; (B) 


; (C) 


; CD) 


> (E) 


FORMAT ABOVE 


FORMAT 


FORMAT 


FORMAT 


FORMAT 
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F9OFF: 
FAOO: 
FAO]: 
FAO2: 
FAQ3: 
FAO4: 
FAQS: 
FAO6: 
FAO7: 
FA08: 
FAO9: 
FAOA: 
FAOB: 
FAOC: 
FAOD: 
FAOE: 
FAOF: 
FA1O: 
FAL1: 
FA12: 
FA13: 
FAL4: 
FAL5: 
FAL6: 
FA17: 
FAL8: 
FA19: 
FAIA: 
FAIB: 
FAIC: 
FAID: 
FALE: 
FAIF: 
FA20: 
FA21: 
FA22: 
FA23: 
FA24: 
FA25: 
FA26: 
FA27: 
FA28: 
FA29: 
FA2A: 


FA2B: 
FA2C: 
FA2D: 
FA2E: 
FA2F: 
FA30: 
FA31: 
FA32: 
FA33: 


525 MNEMR 


DFB $B2 
568 
569 
570 
571 
572 
573 
574 
575 
576 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


SAO 
SD8 
$62 
S5A 
$48 
$26 
$62 
$94 
$88 
$54 
S44 
Sc8 
S54 
$68 
$44 
SE8 
$94 
$00 
SB4 
$08 
$84 
$74 
SB4 
$28 
S6E 
$74 
SF4 
SCC 
S4A 
$72 
SF2 
SA4 ; (A) FORMAT 
SBA 
$00 
SAA 
SA2 
SA2 
S74 
$74 
$74 - (B) FORMAT 
$72 
$44 
$68 


$32 
SB2 
$00 
$22 - (C) FORMAT 
$00 
SIA 
S1A 
$26 
$26 
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FA34:72 
FA35:72 
FA36:88 
FA37:C8 
FA38:C4 
FA39:CA 
FA3A:26 
FA3B:48 
FA3C:44 
FA3D:44 
FA3E:A2 
FA3F:C8 
FA4O: 

FA40: 

FA4O: 

FA40:85 
FA42:A5 
FA44:4C 
FA47: 

FA47 :8D 
FA4A:85 
FA4C: 

FA4C:28 
FA4D:20 
FA50:68 
FA51:85 
FA53:68 
FA54:85 
FA56 :6C 
FA59: 

FA59:20 
FA5C:20 
FASF:4C 
FA62:D8 
FA63:20 
FA66:20 
FA69: 20 
FA6C:20 
FA6F: AD 
FA72:AD 
FA75:A0 
FA/7:20 
FA7A:EA 
FA7B:AD 
FA7E:2C 
FA81:D8 
FA82:20 
FA85: AD 
FA88:49 
FA8A:CD 
FA8D: DO 
FA8F: AD 
FA92:DO 
FA94:A9 
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C3FA 


C3 


co 


FF 


* 
NEWIRQ 
* 


OLDIRQ 


* 


NEWBREAK STA 


* 
BREAK 


RESET 


INITAN 


NEWMON 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


EQU 
STA 
LDA 
JMP 


STA 


PLP 
JSR 


$72 
$72 
$88 
$c8 
$c4 
SCA 
$26 
$48 
$44 
$44 
SA2 
$c8 


SC3FA 
$45 


$45 
NEWIRQ 


; (D) FORMAT 


; (E) FORMAT 


snew IRQ entry 


;(should never be used) 
sfor those who save A to $45 
;go to interrupt handler 


SETSLOTCXROM ;force in slots 


ACC 


SAV1 
PCL 


PCH 
( BRKV ) 


INSDS1 
RGDSP1 
MON 


SETNORM 
INIT 
SETVID 
SETKBD 
SETANO 
SETANI 
#9 
GOTOCX 


CLRROM 
KBDSTRB 


BELL 
SOFTEV+1 
#SA5 
PWREDUP 
PWRUP 
SOFTEV 
NOF IX 
#SEO 


ssave accumulator 


;SAVE REG'S ON BREAK 
; INCLUDING PC 


;BRKV WRITTEN OVER BY DISK BOOT 


;PRINT USER PC 

; AND REGS 

;GO TO MONITOR (NO PASS GO, NO $200!) 
;DO THIS FIRST THIS TIME 


; ANO TTL LO 

; ANI TTL LO 

: CODE=INIT/RRA0981 

;DO APPLE2E INIT/RRA0981 
-/RRAO981 

; TURN OFF EXTNSN ROM 

; CLEAR KEYBOARD 


; CAUSES DELAY IF KEY BOUNCES 
-IS RESET HI 

:A FUNNY COMPLEMENT OF THE 

; PWR UP BYTE 2??? 

; NO SO PWRUP 

: YES SEE IF COLD START 

; HAS BEEN DONE YET? 


; DOES SOFT ENTRY VECTOR POINT AT BASIC? 
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FA96:CD F3 03 631 CMP SOFTEV+1 


FA99:DO 08 FAA3 632 BNE NOFIX ; YES SO REENTER SYSTEM 
FA9B:A0 03 633 FIXSEV LDY #3 ; NO SO POINT AT WARM START 
FA9D:8C F2 03 634 STY SOFTEV ; FOR NEXT RESET 

FAAON:4C 00 EO 635 JMP BASIC ; AND DO THE COLD START 
FAA3:6C F2 03 636 NOFIX JMP (SOFTEV) ; SOFT ENTRY VECTOR 
FAA6: 637 KRRARAKKAKKKKRERKKE 

FAA6:20 60 FB 638 PWRUP JSR APPLETII 

FAAS: FAAQO 639 SETPG3 EQU * ; SET PAGE 3 VECTORS 
FAA9:A2 05 640 LDX #5 

FAAB:BD FC FA 641 SETPLP LDA PWRCON-1,X 3; WITH CNTRL B ADRS 
FAAE:9D EF 03 642 STA BRKV-1,X ; OF CURRENT BASIC 

FAB] :CA 643 DEX 

FAB2:DO F/ FAAB 644 BNE SETPLP 

FAB4:A9 C8 645 LDA #SC8 ; LOAD HI SLOT +1 
FAB6:86 00 646 STX LOCO : SETPG3 MUST RETURN X=0 
FAB8:85 01 647 STA LOC1 ; SET PTR H 

FABA: 648 * 

FABA: 649 * Check 3 ID bytes instead of 4. Allows devices 
FABA: 650 * other than Disk II's to be bootable. 

FABA: 651 * 

FABA:AO 05 652 SLOOP LpyY #5 sY is byte ptr 

FABC:C6 Ol 653 DEC LOCI 

FABE:A5 O01 654 LDA LOC1 

FACO:C9 CO 655 CMP #SCO ; AT LAST SLOT YET? 
FAC2:FO D7 FAIB 656 BEQ FIXSEV ; YES AND IT CAN'T BE A DISK 
FAC4:8D F8 07 657 STA MSLOT 

FAC7:Bl 00 658 NXTBYT LDA (LOCO),Y ; FETCH A SLOT BYTE 
FAC9:D9 Ol FB 659 CMP DISKID-1,Y ; IS IT A DISK ?? 
FACC:DO EC FABA 660 BNE SLOOP ; NO, SO NEXT SLOT DOWN 
FACE :88 661 DEY 

FACF:88 662 DEY ; YES, SO CHECK NEXT BYTE 
FADO:10 F5 FAC/ 663 BPL NXTBYT ; UNTIL 3 BYTES CHECKED 
FAD2:6C 00 OO 664 JMP (LOCO) ; GO BOOT... 

FADS: 665 * 

FAD5:EA 666 NOP 

FAD6:EA 667 NOP 

FAD/7: 668 * 

FAD7:20 8E FD 669 REGDSP JSR CROUT ;DISPLAY USER REG CONTENTS 
FADA:A9 45 670 RGDSP1 LDA #$45 ;WITH LABELS 

FADC:85 40 671 STA A3L 

FADE: A9 00 672 LDA #$00 

FAEO:85 41 673 STA A3H 

FAE2:A2 FB 674 LDX #SFB 

FAE4:A9 AO 675 RDSP1 LDA #SA0 

FAE6:20 ED FD 676 JSR COUT 

FAE9:BD 1E FA 677 LDA RTBL-251,X 

FAEC:20 ED FD 678 JSR COUT 

FAEF:A9 BD 679 LDA #SBD 

FAF1:20 ED FD 680 JSR COUT 

FAF4:B5 4A 681 LDA ACC+5,X 

FAF6:20 DA FD 682 JSR PRBYTE 

FAF9:E8 683 INX 

FAFA:30 E8 FAE4 684 BMI RDSP1 
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FAFC: 
FAFD: 
FAFD: 
FAFF: 
FBO2: 
FBO6: 
FBO9: 
FB11: 
FB11: 
FB14: 
FB16: 
FB19: 
FB19: 
FBIC: 
FBLE: 
FB21: 
FB23: 
FB24: 
FB25: 
FB28: 
FB2A: 
FB2B: 
FB2D: 
FB2E: 
FB2F: 
FB2F: 
FB31: 
FB33: 
FB36: 
FB39: 
FB3C: 
FB3E: 
FB40: 
FB43: 
FB46: 
FB49: 
FB4B: 
FB4D: 
FB4F: 
FB51: 
FB53: 
FB55: 
FB57: 
FB59: 
FB5B: 
FB5D: 
FB60: 
FB60: 
FB63: 
FB65: 
FB68: 
FBOB: 
FB6C: 
FB6E: 
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FB2E 


FB25 


FBB4 


FC 


FC 


FF 
04 


FB65 


* 
PWRCON 


DISKID 


XLTBL 


PREAD2 


SETTXT 


SETGR 


SETWND 


TABV 


* 
APPLEII 


STITLE 


OLDBRK 
$00 ,$E0O,$45 
$20,$FF,$00,$FF 
$03 ,SFF,$3C 
"Apple }C' 
* 
$c4 ,$C2,$Cl 
SFF,$C3 
SFF,SFF,$FF 
$C1,$D8,$D9 ;REGISTER NAMES FOR REGDSP: 
$D0 ,$D3 : "AXYPS* 
PTRIG ;TRIGGER PADDLES 
#500 - INIT COUNT 
;COMPENSATE FOR 1ST COUNT 
PADDLO,X ;COUNT Y-REG EVERY 12 USEC. 
RTS2D 
PREAD2 SEXIT AT 255 MAX 
#500 ;CLR STATUS FOR DEBUG SOFTWARE 
STATUS 
LORES 
LOWSCR ; INIT VIDEO MODE 
TXTSET ;SET FOR TEXT MODE 
#500 ; FULL SCREEN WINDOW 
SETWND 
TXTCLR ;SET FOR GRAPHICS MODE 
MIXSET ;LOWER 4 LINES AS TEXT WINDOW 
CLRTOP 
#514 
WNDTOP ;SET FOR 40 COL WINDOW 
#500 ;TOP IN A-REG, 
WNDLFT ; BOTTOM AT LINE $24 
#SC :CODE=SETWND /RRAO981 
GOTOCX 
#$18 
WNDBTM 
#$17 -VTAB TO ROW 23 
CV ;VIABS TO ROW IN A-REG 
VTAB 
HOME ;CLEAR THE SCRN 
#9 
TITLE-1,Y ;GET A CHAR 
LINE1+14,Y ;PUT IT AT TOP CENTER OF SCREEN 
STITLE 
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FBOF: 
FBOF: 
FB/72: 
FB/4: 
FB/7: 
FB/78: 
FB/8: 
FB78: 
FB7A: 
FB/C: 
FB/F: 
FB81: 
FB83: 
FB85: 
FB88: 
FB8B: 
FB8D: 
FB8F: 
FB91: 
FB94: 
FB97: 
FB97: 
FB98: 
FBOB: 
FB9IC: 
FBOF: 
FBA2: 
FBA5S: 
FBA?7: 
FBAY: 
FBAB: 
FBAD: 
FBAF: 
FBBI: 
FBB3: 
FBB3: 
FBB3: 
FBB3: 
FBB3: 
:06 
FBB4: 

FBB4: 

S20 
:08 
:8D 
FBBB: 
FBBE: 
:00 
FBBF: 
FBCO: 
FBCO: 
FBC1: 
748 
4A 


FBB3 


FBB4 
FBB/ 
FBB8 


FBBE 


FBC1 
FBC2 


4c 


00 


EO 


F3 03 
A5 
F4 03 


8D 
18 
00 cO 
13 
93 
OF 
10 CO 
00 CO 
FB 
83 
03 
10 CO 
FD FB 


2C FC 


48 FA 
97 FB 
21 FD 
CE 
EE 
C9 
EA 
CC 
E6 
E8 


15 co 


07 CO 
00 Cl 


FB9 7 


FB9 7 


FB9 7 
FB9 B 


COO 6 


C00 7 
cO1 5 


FBB4 


31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
ii 
78 
79 
80 
81 
82 
83 
84 


* 
SETPWRC LDA SOFTEV+1 ;ROUTLNE TO CALCULATE THE 'FUNNY 
EOR #SA5 *COMPLEMENT' FOR THE RESET VECTOR 
STA PWREDUP 
RTS 
& 
VIDWAIT EQU * ;CHECK FOR A PAUSE (CONTROL-S). 
CMP #S8D sONLY WHEN I HAVE A CR 
BNE NOWAIT sNOT SO, DO REGULAR 
LDY KBD -IS KEY PRESSED? 
BPL NOWAIT -NO. 
CPY #$93 sYES —-- IS IT CTRL-S? 
BNE NOWAIT -NOPE - IGNORE 
BIT KBDSTRB *CLEAR STROBE 
KBDWAIT LDY KBD *WAIT TILL NEXT KEY TO RESUME 
BPL KBDWAIT WAIT FOR KEYPRESS 
CPY #$83 :IS IT CONTROL-C? 
BEQ NOWAILT sYES, SO LEAVE IT 
BIT KBDSTRB CLR STROBE 
NOWAIT JMP VIDOUT “DO AS BEFORE 
k 
ESCOLD SEC s INSURE CARRY SET 
JMP ESCl 
ESCNOW TAY USE CHAR AS INDEX 
LDA XLTBL-$C9,Y ;TRANSLATE IJKM TO CBAD 
JSR ESCOLD ;DO THE CURSOR MOTION 
JSR RDESC ;GET LJKM, ijkm, ARROWS/RRA0981 
ESCNEW CMP #SCE -IS THIS AN 'N'? 
BCS ESCOLD ;'N' OR GREATER - DO IT! 
CMP #SC9 “LESS THAN 'I'? 
BCC ESCOLD sYES, SO DO OLD WAY 
CMP #SCC -IS IT AN 'L'? 
BEQ ESCOLD ;DO NORMAL 
BNE ESCNOW ;GO DO IT 
* 
SETSLOTCXROM EQU $CO06~ ;/RRAO981 
SETINTCXROM EQU $C007 ; /RRAO981 
RDCXROM EQU SCO15 ; /RRAO 981 
* /RRAO981 
VERSION DFB $06 FOR LDCHECK/RRA0981 
* 
GOTOCX EQU * ; /RRAO 981 
BIT RDCXROM -GET CURRENT STATE/RRA0981 
PHP >SAVE ROMBANK STATE/RRAO981 
STA SETINTCXROM ;SET ROMS ON/RRAO0981 
JMP CLORG °=>OFF TO CXSPACE/RRAO981 
* 
DFB O 
DFB 0 
* 
ZIDBYTE DFB SEO ;//e ROM rev ID byte 
* 
BASCALC PHA sCALC BASE ADDR IN BASL,H 
LSR A ;FOR GIVEN LINE NO. 
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FBC3: 
FBC5: 
FBC7: 
FBC9: 
FBCA: 
FBCC: 
FBCE: 
FBDO: 
FBD2: 
FBD3: 
FBD4: 
FBD6: 
FBD8: 
FBD9: 
FBD9: 
FBDB: 
FBDD: 
FBDF: 
FBE2: 
FBE4: 
FBE6: 
FBE9: 
FBEC: 
FBED: 
FBEF: 
FBFO: 
FBFO: 
FBF2: 
FBF4: 
FBF6: 
FBF8: 
FBFA: 
FBFC: 
FBFD: 
FBFD: 
FBFF: 
FCOL: 
FCO2: 
FCO4: 
FCO6: 
FCO8: 
FCOA: 
FCOC: 
FCOE: 
FC10: 
FC12: 
FC14: 
FC16: 
FC18: 
FCI1A: 
FCIC? 
FCIE: 
FC20: 
FC2Z2: 


360 


FBDO 


FBEF 


FC 


FC 


co 


FBE4 


FC62 


FBFO 


FBFO 


FC62 


FC66 


FBD9 


FBFC 


FBFC 


BASCLC2 


BELL2 


RTS2B 
* 


STORADV 


ADVANCE 


RTS3 
* 


VIDOUT 


BS 


UP 


#$03 
#$04 
BASH 


#518 
BASCLC2 
#S7F 
BASL 


CH 


(BASL) ,Y 


CH 
CH 
WNDWDTH 
CR 


#SA0 
STORADV 


STORADV 
#S8D 


RTS3 
WNDWDTH 
CH 

CH 
WNDTOP 


; O<=LINE NO.<=$17 
;ARG = OOOABCDE, GENERATE 
; BASH = OOOO01CD 
; AND 
; BASL = EABABOOO 


;BELL CHAR? (CONTROL-G) 
; NO, RETURN. 

; YESe.ee 

;DELAY .Ol1 SECONDS 


-TOGGLE SPEAKER AT 1 KHZ 
- FOR .1 SEC. 


;CURSOR H INDEX TO Y-REG 
;STORE CHAR IN LINE 

s INCREMENT CURSOR H INDEX 
; (MOVE RIGHT) 

sBEYOND WINDOW WIDTH? 

; YES, CR TO NEXT LINE. 

; NO, RETURN. 


;sCONTROL CHAR? 

; NO, OUTPUT IT. 

; INVERSE VIDEO? 

; YES, OUTPUT IT. 

CR? 

; YES. 

;LINE FEED? 

; IF SO, DO IT. 

;BACK SPACE? (CONTROL-H) 

; NO, CHECK FOR BELL. 
;DECREMENT CURSOR H INDEX 
;IF POSITIVE, OK; ELSE MOVE UP. 
;SET CH TO WINDOW WIDTH - l. 


;(RIGHTMOST SCREEN POS) 
;CURSOR V_ INDEX 


;1[F TOP LINE THEN RETURN 
;DECR CURSOR V INDEX 
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FC22: 
FC24: 
FC26: 
FC27: 
FC29: 
FC2B: 
FC2B: 
FC2C: 
FC2C: 
FC2E: 
FC30: 
FC32: 
FC34: 
FC36: 
FC38: 
FC3A: 
FC3C: 
FC3E: 
FC40: 
FC42: 
FC42: 
FC42: 
FC44: 
FC46: 
FC46: 
FC49: 
FC4B: 
FC4D: 
FC4F: 
FC50: 
FCS1: 
FC54: 
FC55: 
FC57: 
FC58: 
FC58: 
FC58: 
FCSA: 
FC5D: 
FC5D: 
FC5E: 
FC5SF: 
FC60: 
FC61: 
FC62: 
FC62: 
FC64: 
FC66: 
FC68: 
FC6A: 
FC6C: 
FC6E: 
FC70: 
FC70: 


FBB4 


FC58 


FBF4 
FC1O 


FC66 
FCLA 


FC9OC 
FBFC 


FC42 


FC29 


co 
FC4F 
FC5A 


FB 


FC58 


FB 


FC24 


FC 70 


VTAB 
VTABZ 


GOTOCX] 
* 


ESC1 


* 
CLREOP 


NEWVW1 


HOME 


GOTOCX3 
* 


CR 


LF 


* 
SCROLL 


BCC 
DEC 


EQU 


CV 
BASL 


#$4 
GOTOCX 


#$CO 
HOME 
#SFD 
ADVANCE 


#SA 
GOTOCX1 


RD80VID 
NEWVW1 
#$0 
GOTOCX3 


VIDWAIT 


YSAV1 


* 


#5 
GOTOCX 
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;GET CURSOR V INDEX 
;temporarily save Acc 
sand Y 
;this is VTABZ call 
3=> always perform call 


;ESC '@'? 

; LF SO DO HOME AND CLEAR 
;ESC-A OR B CHECK 

; A, ADVANCE 

; B, BACKSPACE 

;ESC-C OR D CHECK 

- C, DOWN 

; D, GO UP 

sESC-E OR F CKECK 

; E, CLEAR TO END OF LINE 
: ELSE NOT F,RETURN 


;/RRAO981 
; CODE=CLREOP/RRA0981 
;DO 40/80 /RRA0981 


sin 80 columns? 

;=>not 80 columns 
;Print a character 
;through video firmware 
;get masked character 
;and set up for vidwait 
;print the character 
;restore Acc 

sand Y 


;/RRAO981 
s CODE=HOME /RRAO98 1 
sdo 40/80 


;CURSOR TO LEFT OF INDEX 
;(RET CURSOR H=0) 
;INCR CURSOR V. (DOWN 1 LINE) 


;OFF SCREEN? 
- NO, SET BASE ADDR 
sDECR CURSOR V. (BACK TO BOTTOM) 


;/RRAO981 
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FC70: 
FC72: 
FC74: 
FC74: 
FC74: 
FC74: 
:8D 
:6C 
FC7A: 
FC7A: 
FC7A: 
FC7A: 
FC7A: 
FC7B: 
FC7E: 
FC80: 
FC82: 
FC85: 
FC87: 
FC89: 
FC8B: 
FC8D: 
FC8F: 
FC92: 
FC95: 
FC95: 
FC97: 
FC99: 
FC9C: 
FC9IC: 
FC9C: 
FCIC: 
FC9C: 
FC9C: 
FC9C: 
FC9D: 
FC9E: 
FC9F: 
FCAL: 
FCA3: 
FCAS: 
FCA6: 
FCA8: 
FCA8: 
FCA9: 
FCAA: 
FCAC: 
FCAE: 
FCAF: 
FCBI: 
FCB3: 
FCB4: 
FCB4: 
FCB6: 


FC74 
FC77 


362 


AO 
DO 


06 
B5 


06 
FE 


42 
02 


co 
03 


co 
C4 


FD 


FC29 


FC99 


0000 


FD1D 


FD1D 


FCAA 


FCA9 


FCBA 


193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 


LDY 


BNE 
* 


* Jump here 


#6 ; CODE=SCROLL/RRAO981 
GOTOCX1 ;DO 40/80 /RRAO0981 


to swap out ROMs 


* for interrupt handlers in peripheral cards 


* 


IROQUSER STA 


JMP 
* 


SETSLOTCXROM ;switch in slots 
($3FE) ;and jump to user 


* IRQDONE ($C3F4) jumps here after interrupt 
* because this cannot be done from $Cn00 space 


* 


IRQDONE2 PLA 


STA 
CMP 
BCC 
STA 
LDY 
LDX 
STA 
LDA 
STX 


;Fix $C800 space 


MSLOT ;restore MSLOT 

#SC1 svalid Cn? 

IRQNOSLT 

SCFFF ;Deselect all $C800 
#0 

$] 

$1 

($0),Y ;do $Cn00 reference 
$1 ;fix zp location 


IRQNOSLT STA SETINTCXROM 


JMP 
* 
DOCOUT1 BCC 
AND 
DOCOUT2 JMP 
* 


DS 
* 


IRQFIX ;and restore the machine state 
DOCOUT2 sdon't mask controls 

INVFLG ;sapply inverse mask 

COUTZ1 3g0 back to COUTI 


F8ORG+$49C-* ,0 ;pad to clreol 


* Note: bytes CLREOL and CLREOLZ ($38 and $18) 
* are used by slot test at S$FBB7. 


* 


CLREOL SEC 
DFB 
CLREOLZ CLC 
STY 
LDY 
BCS 
INY 
BNE 


WAIT SEC 
WAIT2 PHA 
WAIT3 SBC 
BNE 
PLA 
SBC 
BNE 
RTS 


NXTA4 INC 
BNE 


;say it is EOL 
$90 ;'BCC' opcode 

;say it is EOLZ 
BAS2L ;save Y in temp 
#7 ;code=CLREOL 
GOTOCX2 sdo it 


;code 8=CLREOLZ 


GOTOCX2 
senter with count in A 
;delay is: 
#S$01 
WAIT3 313+11*A+5*A*A cycles 
;@ 1.023 usec per cycle 
#S01 
WAIT2 
ASL -INCR 2-BYTE A4 
NXTAI ; AND Al 
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FCB8: 
FCBA: 
FCBC: 
FCBE: 
FCCO: 
FCC2; 
FCC4: 
FCC6: 
FCC8: 
FCC9: 
FCC9: 
FCCC: 
FCCF: 
FCD2: 
FCD2: 
FCD2: 
FCD2: 
FCD2: 
FCN2: 
:8D 
220 
:A9 
FCDA: 
FCDD: 
:4C 
FCE3: 

:8D 
220 
220 
384 


FCD2 
FCD5 
FCD8 


FCEO 


FCE3 
FCE6 
FCE9 
FCEC 


FCEE: 
FCFO: 
FCFO: 
FCFO: 
FCFO: 
:A9 
785 
:20 
:8D 
FCFA: 
FCFD: 
FCFD: 
:C8 
:C9 
:90 
:C9 
FDO7: 
329 
:60 
FDOC: 

: AO 
:DO 
:4C 
220 


FCFO 
FCF2 
FCF4 
FCF/ 


FDOO 
FDO1 
FDO3 
FDO5 


FDO9 
FDOB 


FDOC 
FDOE 
FD10 
FD13 


20 
20 


85 


4C 


B9 


BO 


43 
3C 
3E 
3D 
3F 
3C 
02 
3D 


07 
67 
c5 


06 
4A 
DE 
ED 
3A 
FQ) 


06 
DO 
a3 
3B 
3A 


Al 
33 
67 
07 
9C 


00 


El 
06 
FB 
02 
DF 


OB 
03 
18 
B4 


co 
C5 
FE 


co 
F9 


FD 
FF 
FC 


CO 
F8 
FY 


FD 
CO 
CF 


02 


FD 
FB 


FCC8 


FD OB 


FDOB 


FD 13 


247 
248 
249 
250 
251 
252 
233 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
a 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 


INC 
NXTA1 LDA 
CMP 
LDA 
SBC 
INC 
BNE 
INC 
RTS4B RTS 


HEADR STA 
JSR 
JMP 


+ + + * FF 


ERR3 STA 
JSR 
LDA 
JSR 
JSR 
JMP 

* 

DISLIN STA 
JSR 
JSR 
STY 
STA 


* 

* 

* 

* 

GETINST1 LDA 
STA 
JSR 
STA 
JMP 

* 

UPMON LDA 
INY 
CMP 
BCC 
CMP 
BCS 
AND 

UPMON2 RTS 

* 

RDKEY LDY 
BNE 

FD10O JMP 

RDKEYO JSR 


A4H 

ALL ;LNCR 2-BYTE Al. 
A2L ; AND COMPARE TO A2 
AlH ; (CARRY SET IF >=) 
A2H 

ALL 

RTS4B 

AlH 


SETINTCXROM ;force internal ROM 
XHEADER ;swrite header 
RETCX1 sforce slots and return 


For the disassembler to be able to do I/O to slots, 
it cannot make calls to the 1/0 routines with the 
internal ROM switched in. This stuff switches the 
ROM out for such instances. 


SETSLOTCXROM ;force slot ROM 


PRBL2 ;tab to the error 
#SDE ;to primt a caret "“" 
COUT ;print it 

BELL sand beep 


GETINSTlL j;and go get next instruction 


SETSLOTCXROM ;force slot ROM 
INSTDSP sdisassemble the instruction 


PCADJ scalculate new PC 
PCH ;and update PC 
PCL 


NOTE: The entry point GETINST1 is hard-coded in 
BFUNC of the Video firmware. 


#SA1 szet mini-prompt 
PROMPT 

GETLNZ 3g0 get a line of input 
SETINTCXROM ;force internal ROM 


DOINST sand return to CX space 
IN,Y ;get character 
;point to next char 
#SE] sis it lowercase? 
UPMON2 3;=>nope 
#SFB ;lowercase? 
UPMON2 ;=>nope 
SDF selse upshift 
#SB ;code=RDKEY 
RDKEYO sallow $FDLO entry 
RDKEY 1 ;if enter here, do nothing 


GOTOCX ;display cursor 
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FD16: 
:EA 
FD18: 
FDIB: 
FDIB: 
FDIB: 
FDID: 
7EA 
FD21: 

FD21: 

:20 
: AO 
:DO 
FD28: 
FD28: 
FD28: 
FD28: 
FD28: 
FD28: 
FD28: 
FD2B: 
FD2E: 
FD2F: 
FD2F: 
FD32: 
FD35: 
FD38: 
FD3A: 
FD3C: 
FD3D: 
FD3D: 
FD3F: 
FD42: 
FD44: 
FD47: 


FD1/ 


FD20 


FD21 
FD24 
FD26 


FD47: 
FD4A: 
FD4B: 
FD4C: 
FD4D: 
FD50: 
FD52: 
FD54: 
FD56: 
FD58: 
FD5A: 
FDSC: 
FD5F: 
FD60: 
FD62: 
FD62: 
FD64: 
FD67: 
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EA 


6C 


AO 
4C 


38 


03 
B4 


OC 
01 
F5 


ED 


FD1B 


07 
FD 


FD 
FB 
FD 


FD2F 


FB 


02 


FD 


02 


FD71 


FD62 


FD5F 
FF 


FD75 


FD 
FD 


RDKEY 1 
* 


KEYIN 


GOTOCX2 


* 
RDESC 


* 


NOP 
NOP 
JMP 


EQU 
LDY 
JMP 
NOP 


EQU 
JSR 
LDY 
BNE 


(KSWL) 


* 


#3 
GOTOCX 


* 


RDKEY 
#1 


GOTOCX2 


;GO TO USER KEY-IN 


- RDKEY/RRA0981 
-/RRAOI81 
; /RRAOI81 


;sGET A KEY 
s CODE=FIXIT 
;=Palways 


* Flag to the video firmware that escapes are allowed. 
* This routine is called by RDCHAR which is called by 
The high bit of MSLOT is set by all cards 

* that use the C800 space. 


* GETLN. 


* 


NEWRDKEY LSR MSLOT 


PICKFIX 


*#03 AUTOST2 


NOTCR 


NOTCRI 


* 
CANCEL 


GETLNZ 


JMP 
NOP 


JSR 
JSR 
JSR 
CMP 
BEQ 
RTS 


LDY 
JSR 
LDY 
STA 


JSR 
NOP 
NOP 
NOP 
LDA 
CMP 
BEQ 
CMP 
BEQ 
CPX 
BCC 
JSR 
INX 
BNE 


LDA 
JSR 
JSR 


RDKEY 


RDESC 
ESCNEW 


NEWRDKEY 


#S9B 
ESC 


#SF 
GOTOCX 
CH 
IN,X 


COUT 


IN, X 
#588 
BCKSPC 
#598 
CANCEL 
#SF8 
NOTCRI 
BELL 


NXTCHAR 


#SDC 
COUT 
CROUT 


3<128 means escape allowed 
snow read the key 


;/RRAO9 81 

;HANDLE ESC FUNCTION. 
;Flag RDCHAR and read key 
sTESC'? 


; YES, DON'T RETURN. 


;code = fixpick 

3do 80 column pick 

;restore Y 

sand save new character 
Auto~Start Monitor ROM 27-AUG-84 


;echo typed char 


;CHECK FOR EDIT KEYS 
; 7— BACKSPACE 


; — CONTROL-X 
;MARGIN? 

; YES, SOUND BELL 
;ADVANCE INPUT INDEX 


; BACKSLASH AFTER CANCELLED LINE 


sOUTPUT 'CR! 
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FD6A: 
FD6C: 
FD6F: 
FD/1: 
FD72: 
FD/4: 
FD/5: 
FD/8: 
FD7A: 
FD/C: 
FD/E: 
FD81: 
FD83: 
FD84: 
FD87: 
FD89: 
FD8B: 
FD8E: 
FD90: 
FD92: 
FD92: 
FD94: 
FD96: 
FD99: 
FD9C: 
FD9E: 
FDAO: 
FDA3: 
FDA3: 
FDA5S: 
FDA/7: 
FDA9: 
FDAB: 
FDAD: 


FDAF 


229 
FDBI: 
FDB3: 
FDB6: 
FDB8: 
FDBB: 
FDBD: 
FDCO: 
FDC3: 
FDC5: 
FDC6: 
FDC6: 
FDC7: 
FDC9: 
FDCA: 
FDCB: 
FDCD: 
FDCF: 
FDD1: 


EA 


3E 
02 
FF 
3C 


FD 


FD67 


FD 


FD84 


co 
FD 3D 


02 


FD47 
FC 


FDED 


FD 
F9 


FD 


A1LL 


FDB6 
FD 


FD 
FD 


FC 
FDAD 


FDB3 


FDD1 


GETLN 


BCKSPC 


NXTCHAR 


ADDINP 


XAM8 


MO 


XAM 
DATAOUT 


RTS4C 
* 


XAMPM 


ADD 


LDA 
JSR 
LDX 
TXA 
BEQ 
DEX 
JSR 
CMP 
BNE 
LDA 
BIT 
BMI 
NOP 
STA 
CMP 
BNE 
JSR 
LDA 
BNE 


LDY 
LDX 
JSR 
JSR 
LDY 
LDA 
JMP 


LDA 
ORA 
STA 
LDA 
STA 


AND 
BNE 
JSR 
LDA 
JSR 
LDA 
JSR 
JSR 
BCC 
RTS 


LSR 
BCC 
LSR 
LSR 
LDA 
BCC 
EOR 
ADC 


PROMPT ;OUTPUT PROMPT CHAR 
COUT 

#$01 ; INIT INPUT INDEX 
GETLNZ ;WILL BACKSPACE TO 0 
RDCHAR 

#595 ;USE SCREEN CHAR 


ADDINP ; FOR CONTROL-U 
(BASL),Y ;do 40 column pick 
RD80VID 380 columns? 
PICKFIX s=Dyes, fix it 


IN,X 
#S8D 
NOTCR 
CLREOL 
#S8D 
COUT 


;ADD TO INPUT BUFFER 


-CLR TO EOL IF CR 
: (ALWAYS) 


AlH sPRINT CR,Al IN HEX 
ALL 
CROUT 
PRNTYX 
#500 
#SAD 
COUT 


sPRINT '-' 


ALL 

#$07 ;SET TO FINISH AT 
A2L ; MOD 8=7 

AlH 

A2H 


#$07 
DATAOUT 
PRAL 
#SA0 
COUT 
(ALL) ,Y 
PRBYTE 
NXTAI1 
MOD8CHK 


;OUTPUT BLANK 
;OUTPUT BYTE IN HEX 


;NOT DONE YET. GO CHECK MOD 8 
; DONE. 


A ;DETERMINE IF MONITOR MODE IS 
XAM ; EXAMINE, ADD OR SUBTRACT 


;FORM 2'S COMPLEMENT FOR SUBTRACT. 
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FDD3 :48 
FDD4: A9 
FDD6:20 
FDD9 :68 
FDDA:48 
FDDB:4A 
FDDC:4A 
FDDD:4A 
FDDE:4A 
FDDF:20 
FNE2 :68 
FNE3 :29 
FDE5 :09 
FDE7:C9 
FDE9 :90 
FDEB: 69 
FDED: 

FDED:6C 
FDFO: 

FDFO:48 
FDF1:C9 
FDF3:4C 
FDF6: 

FDF6:48 
FDF7 :84 
FDF9:A8 
FDFA:68 
FDFB:4C 
FDFE:EA 
FDFF:EA 
FEOO: 

FEOO :C6 
FEO2: FO 
FEO4:CA 
FEO5: DO 
FEO7:C9 
FEO9: DO 
FEOB:85 
FEOD: A5 
FEOF :91 
FE11:E6 
FE1L3:DO 
FE1L5:E6 
FE17:60 
FE18: 

FE1L8:A4 
FE1A: B9 
FE1D:85 
FELF:60 
FE20: 

FE20: A2 
FE22:B5 
FE24:95 
FE26:95 
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BD 
ED 


ES 
OF 
BO 
BA 
02 
06 
36 


AO 
95 


35 


46 


FD 


FD 


00 


FC 


FC 


01 


FDED 


FDA3 


FE1D 


FDC6 


FE17 


PRBYTE 


PRHEX 
PRHEXZ 


COUTZ 
COUTZ1 


STOR 


RTS5 
x 


SETMODE 


SETMDZ 


* 


LT 
LT2 


#S$ BD 
COUT 


A 
A 
A 
A 
PRHEXZ 


#SOF 
#SBO 
#SBA 
COUT 
#$06 


(CSWL) 


#S$A0 
DOCOUT1 


YSAV1 


NEWVW 


YSAV 
XAM8 


SETMDZ 
#SBA 
XAMPM 
MODE 
A2L 
(A3L),Y 
A3L 
RTS5 
A3H 


YSAV 
IN-1,Y 
MODE 


#$01 

A2L,X 
AGL,X 
ASL,X 


;PRINT '=', THEN RESULT 


;PRINT BYTE AS 2 HEX DIGITS 
; (DESTROYS A-REG) 


;PRINT HEX DIGIT IN A-REG 
;LSBITS ONLY. 


;VECTOR TO USER OUTPUT ROUTINE 


;save original character 
;is it a control? 


s=>mask if not; return to COUTZ]I 


;save original character 
;save Y 

;save masked character 
;get original char 
snew entry to vidwait 


-BLANK TO MON 

;AFTER BLANK 

:DATA STORE MODE? 

; NO; XAM, ADD, OR SUBTRACT. 
*KEEP IN STORE MODE 


;STORE AS LOW BYTE AT (A3) 


-INCR A3, RETURN. 


sSAVE CONVERTED ':', '+! 


'-") 4.1 AS MODE 


sCOPY A2 (2 BYTES) TO 
> A4 AND AS 
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FE28: 
FE29: 
FE2B: 
FE2ZC: 
FE2C: 
FE2E: 
FE30: 
FE33: 
FE35: 
FE36: 
FE36: 
FE38: 
FE3A: 
FE3C: 
FE3F: 
FE41: 
FE44: 
FE46: 
FE49: 
FE4B: 
FE4E: 
FE5O: 
FE53: 
FE55: 
FE58: 
FE5B: 
FESD: 
FE5SE: 
FE5SE: 
FE61: 
FE63: 
FE64: 
FE67: 
FE6A: 
FEO6C: 
FE6E: 
FE6F: 
FE70: 
FE72: 
FE74: 
FE/5: 
FE/5: 
FE/6: 
FE/78: 
FE7A: 
FE/C: 
FE7D: 
FE/F: 
FE80: 
FE80: 
FE82: 
FE84: 
FE86: 
FF88: 


FC 


FE 


F8 
F9 


FE22 


FE2C 


FE58 


FE 36 


FE63 


FE/F 


FE78 


FES6 


MOVE 


VFY 


VFYOK 


* 
Al1PC 


Al PCLP 


AlPCRTS 
* 


SETINV 


SE'TNORM 
SETIFLG 


DEX 
BPL 
RTS 


LDA 
STA 
JSR 
BCC 
RTS 


LDA 
CMP 
BEQ 
JSR 
LDA 
JSR 
LDA 
JSR 
LDA 
JSR 
LDA 
JSR 
LDA 
JSR 
JSR 
BCC 
RTS 


JSR 
LDA 
PHA 
JSR 
JSR 
STA 
STY 
PLA 
SEC 
SBC 
BNE 
RTS 


TXA 
BEQ 
LDA 
STA 
DEX 
BPL 
RTS 


LDY 
BNE 
LDY 
STY 
RTS 


LT2 


(AIL),Y 
(A4L),Y 
NXTA4 
MOVE 


(ALL),Y 
(A4L),Y 
VFYOK 
PRAIL 
(A1L),Y 
PRBYTE 
#SAO 
COUT 
#SA8 
COUT 
(ASL) ,Y 
PRBYTE 
#SA9 
COUT 
NXTA4 
VFY 


Al PC 
#S14 


INSTDSP 
PCADJ 
PCL 

PCH 


#$01 
LIST2 


Al PCRTS 
ALL,X 
PCL,X 


Al PCLP 


#S3F 
SETIFLG 
#SFF 
INVFLG 


;MOVE (Al) THRU (A2) TO (A4) 


sVERIFY (Al) THRU (A2) 
; WITH (A4) 


;MOVE Al (2 BYTES) TO 
; PC IF SPEC'D AND 
; DISASSEMBLE 20 INSTRUCTIONS. 


;ADJUST PC AFTER EACH INSTRUCTION. 


;NEXT OF 20 INSTRUCTIONS 


;IF USER SPECIFIED AN ADDRESS, 


; COPY IT FROM Al TO PC. 


sYEP, SO COPY IT. 


;SET FOR INVERSE VID 


; VIA COUT1 


;oET FOR NORMAL VID 
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FEC5:8D 06 


368 


FE9B 


FEA5 


FB 


co 


a15 
516 


* 
SETKBD LDA #$00 -pDO ‘IN#O' 
INPORT STA A2L ;DO 'IN#AREG' 
INPRT LDX #KSWL 
LDY #KEYIN 
BNE IOPRT 
k 
SETVID LDA #800 -DO 'PR#HO! 
OUTPORT STA A2L ;DO0 'PRHAREG' 
OUTPRT LDX #CSWL 
LDY #COUT1 
IOPRT LDA A2L *SET INPUT/OUTPUT VECTORS 
AND #SOF 
BEQ IOPRT1 
ORA #<IOADR 
LDY #$00 
IOPRT1 STY LOCO,X ;save low byte of hook 
STA LOCI1,X ;save acc 
LDY #SE scode=PR# / IN# 
GOTOCX4 JMP GOTOCX ;perform call 
* 
NOP 
CKSUMFIX DFB 0 ;/RRA098 1 
* 3-->CORRECT CKSUM AT CREATE TIME. 
XBASIC JMP BASIC ;TO BASIC, COLD START 
BASCONT JMP BASIC2 ;TO BASIC, WARM START 
GO JSR AILPC ;ADDR TO PC IF SPECIFIED 
JSR RESTORE ;RESTORE FAKE REGISTERS 
JMP (PCL) ;AND GO! 
REGZ JMP REGDSP ;GO DISPLAY REGISTERS 
TRACE RTS ;TRACE IS GONE 
NOP 
STEPZ RTS ;STEP IS GONE 
* 
* Return here from GOTOCX 
k 
* NOTE: This address is hard-coded in BFUNC of the 
* video firmware 
k 
RETCX1] STA SETSLOTCXROM ;restore bank 
RETCX2 RTS ;simply return 
NOP 
* 
USR JMP USRADR ; JUMP TO CONTROL-Y VECTOR IN RAM 
k 
WRITE LDA #$40 
WRT2 STA SETINTCXROM ;set internal ROM 
JSR WRITE2 swrite to tape 
BEQ RD2 ;=Dalways set slots, beep 


* SEARCH is called with a Monitor command of the form 

* HHLL<ADR1.ADR2 in which ADR1 < ADR2 and LL precedes HH 

* in memory. If HH is 0, or omitted (LL<ADR1.ADR2), then 

* the single byte LL is searched for. You cannot search for 
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FED/7: 
FED/: 
FED/?: 
FED/: 
FED9: 
FEDB: 
FEDD: 
FEDF : 
FEE]: 
FEE2: 
FEE4: 
FEFR6: 
FEE8:: 
FEEB: 
FEEE: 
FEFO: 
FEF]: 
FEF]: 
FEF3: 
FEF6: 
FEF6: 
FEF9: 
FEFA: 
FEFB: 
FEFD: 
FEFD: 
FFOO: 
FFO3: 
FFO6: 
FFO8: 
FFOA: 
FFOA: 
FF13: 
FF13: 
FF13: 
FF13: 
FF16: 
FF18: 
FFIA: 
FFIB: 
FFIB: 
FF1D: 
FFIF: 
FF21: 
FF24: 
FF26: 
FF28: 
FF2A: 
FF2B: 
FF2D: 
FF2D: 
FF2F: 
FF32: 
FF34: 


FEEL 


FEEB 


FEEB 


FED/ 


* a two byte pair with a high byte of 0. 
* adresses containing the specified pattern is displayed. 


* 
SEARCH 


SRCH1 


TITLE 
* 


LDY 
LDA 
BEQ 
CMP 
BNE 
DEY 
LDA 
CMP 
BNE 
JSR 
JSR 
BCC 
RTS 


LDY 
JSR 


JSR 
PLA 
PLA 
BNE 


STA 
JSR 
STA 
BEQ 
BNE 


ASC 


* NNBL gets 


* 
NNBL 


* 
LOOKASC 


PRERR 


JSR 
CMP 
BEQ 
RTS 


BCS 
CMP 
BNE 
LDA 
LDX 
CMP 
BEQ 
INY 
BNE 


LDA 
JSR 
LDA 
JSR 


#1 

A4H 
SRCH1 
(AIL),Y 
SRCH2 


ASL 
(A1L),Y 
SRCH2 
PRA] 
NXTA1 
SEARCH 


#$D 
GOTOCX 


BL1 


MONZ 


A list of all 


;set Y to l 

sis high byte 0? 

;=>yes, only look for low byte 
;check high byte first 
;=>no match, try next byte 
smatch, mow check low byte 
;get low byte 

sdoes it match? 

;=>no match, try next byte 
;bytes match, print address 
sincrement address 

sset Y back to l 


;dispatch mini-assembler call to 
;get internal ROM switched in 


;HANDLE CR AS BLANK 


THEN POP STACK 
AND RETURN TO MON 


; (ALWAYS) 


SETINTCXROM ;set internal ROM 
;do tape read 
SETSLOTCXROM ;restore slot CX 
sread (write) ok, beep 
serror, print message 


XREAD 


BELL 
PRERR 


"Apple 


UPMON 
#S$A0 
NNBL 


DIG 
#$AO 
RTS6 
$200,Y 
#7 
#$8D 
GETNUM 


NXTBIT 


#SC5 
COUT 
#$D2 
COUT 


//e" 


the next non-blank for the mini-assembler 


;get char, upshift, INY 
sis it blank? 
;syes, keep looking 


;it was a digit 
scheck for quote (') 
snope, return char 
;else get mext char 


;for shifting asc into A2L and A2H 


swas it CR? 

syes, go handle CR 

sadvance index 

3=>(always) into A2L and A2H 


;PRINT 'ERR', THEN FALL INTO 


FWEEPER. 


Appendix I: Monitor ROM Listings 


369 


FF37:20 ED FD 623 JSR COUT 


FF3A: 624 * 

FF3A:A9 87 625 BELL LDA #587 ;sMAKE A JOYFUL NOISE, THEN RETURN. 
FF3C:4C ED FD 626 JMP COUT 

FF3F: 627 * 

FF3F:A5 48 628 RESTORE LDA STATUS ;sRESTORE 6502 REGISTER CONTENTS 
FF41:48 629 PHA ; USED BY DEBUG SOFTWARE 
FF42:A5 45 630 LDA ASH 

FF44:A6 46 631 RESTRI1 LDX XREG 

FF46:A4 47 632 LDY YREG 

FF48:28 633 PLP 

FF49 360 634 RTS6 RTS 

FF4A: 635 * 

FF4A:85 45 636 SAVE STA ASH ;SAVE 6502 REGISTER CONTENTS 
FF4C:86 46 637 SAV1 STX XREG ; FOR DEBUG SOFTWARE 

FF4E:84 47 638 STY YREG 

FF50:08 639 PHP 

FF51:68 640 PLA 

FF52:85 48 641 STA STATUS 

FF54:BA 642 TSX 

FF55:86 49 643 STX SPNT 

FF57:D8 644 CLD 

FF58:60 645 RTS 

FF59: 646 * 

FF59:20 84 FE 647 OLDRST JSR SETNORM ;sSET SCREEN MODE 

FF5C:20 2F FB 648 JSR INIT ; AND LNIT KBD/SCREEN 

FF5F:20 93 FE 649 JSR SETVID ; AS I/O DEVS. 

FF62:20 89 FE 650 JSR SETKBD 

FF65: 651 * 

FF65:D8 652 MON CLD ;sMUST SET HEX MODE! 

FF66:20 3A FF 653 JSR BELL ; FWEEPER. 

FF69:A9 AA 654 MONZ LDA #SAA >'*' PROMPT FOR MONITOR 
FF6B:85 33 655 STA PROMPT 

FF6D:20 67 FD 656 JSR GETLNZ ;READ A LINE OF INPUT 

FF70:20 C7 FF 657 JSR ZMODE ;CLEAR MONITOR MODE, SCAN IDX 
FF/73:20 A/7 FF 658 NXTITM JSR GETNUM ;GET LTEM, NON-HEX 

FF76:84 34 659 STY YSAV ; CHAR IN A-REG. 

FF78:A0 17 660 LDY #$17 ; X-REG=0 IF NO HEX INPUT 
FF/7A:88 661 CHRSRCH DEY 

FF/7B:30 E8 FF65 662 BMI MON sCOMMAND NOT FOUND, BEEP & TRY AGAIN. 
FF/D:D9 CC FF 663 CMP CHRTBL,Y ;FIND COMMAND CHAR IN TABLE 
FF80:D0O F8 FF7A 664 BNE CHRSRCH ;NOT THIS TIME 

FF82:20 BE FF 665 JSR TOSUB sGOT LT! CALL CORRESPONDING SUBROUTINE 
FF85:A4 34 666 LDY YSAV ;PROCESS NEXT ENTRY ON HIS LINE 
FF87:4C 73 FF 667 JMP NXTITM 

FF8A: 668 * 

FF8A:A2 03 669 DIG LDX #$03 

FF8C:0A 670 ASL A 

FF8D:0A 671 ASL A ;GOT HEX DIGIT, 

FF8E:0A 672 ASL A ; SHIFT INTO A2 

FF8F:0A 673 ASL A 

FF90:0A 674 NXTBIT ASL A 

FF91:26 3E 675 ROL A2L 

FF93:26 3F 676 ROL A2H 
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FF95: 
FF96: 
FF98: 
FF9A: 
FF9IC: 
FF9E: 
FFAO: 
FFA2: 
FFA3: 
FFAS: 
FFA/: 
FFA/7: 
FFA9: 
FFAB: 
FFAD: 
FFBO: 
FFB1: 
FFB3: 
FFBS: 
FFB/: 
FFB9: 
FFBB: 
FFBE: 
FFBE: 
FFCO: 
FFC1: 
FFC4: 
FFCS: 
FFC7: 
FFC9: 
FFCB: 
FFCC: 
FFCC: 
FFCD: 
FFCE: 
FFCF: 
FFDO: 
FFDI: 
FFD2: 
FFD3: 
FFD4: 
FFDS: 
FFD6: 
FFD/?7: 
FFD8: 
FFD9: 
FFDA: 
FFDB: 
FFDC: 
FFDD: 
FFDE: 
FFDF: 
FFEO: 
FFE1: 


FE90 


FFA2 


FF98 
FF AD 


FC 


FF8A 


FF 


FF 


NXTBAS 


NXTCHR 


ZMODE 


* 
CHRT BL 


NXTBIT 
MODE 
NXTBS2 
A2H,X 
AlH,X 
A3H,X 


NXTBAS 
NXTCHR 


#$00 
A2L 
A2H 
UPMON 


#$BO 
#SOA 
DIG 

#$88 
#SFA 


LOOKASC 


#<GO 


SUBTBL,Y 


MODE 
#$00 
MODE 


SBC 
$B2 
SBE 
S9A 
SEF 
$C4 
SEC 
SA9 
SBB 
$A6 
SA4 
$06 
$95 
$07 
$02 
$05 
SFO 
$00 
SEB 
$93 
SA7 
$C6 


;LEAVE X=SFF IF DIG 


;IF MODE IS ZERO, 
; THEN COPY A2 TO Al AND A3 


sCLEAR A2 


;get char, upshift, INY 


; INY now done in UPMON 


>BR IF HEX DIGIT 


;scheck for ASCII input 


sDISPATCH TO SUBROUTINE, BY 

; PUSHING THE HI-ORDER SUBR ADDR, 
; THEN THE LO-ORDER SUBR ADDR 

; ONTO THE STACK, 

; (CLEARING THE MODE, SAVE THE OLD 
; MODE IN A-REG), 


; AND 'RTS' TO THE SUBROUTINE! 


C (BASIC WARM START) 

“y (USER VECTOR) 

E (OPEN AND DISPLAY REGISTERS) 
! (enter mini-assembler) 

V (MEMORY VERIFY) 

“K (CIN#SLOT) 

Ss (search for 2 bytes) 

“P (PR#SLOT) 

*“B (BASIC COLD START) 

-' (SUBTRACTION) 

+' (ADDITION) 

3M (MEMORY MOVE) 

;'<' (DELIMITER FOR MOVE, VFY) 
;N (SET NORMAL VIDEO) 

I (SET INVERSE VIDEO) 

Li (DISASSEMBLE 20 INSTRS) 
‘Ww (WRITE TO TAPE) 

G (EXECUTE PROGRAM) 

R (READ FROM TAPE) 

"s;' (MEMORY FILL) 

:".' (ADDRESS DELIMITER) 
;'CR' (END OF INPUT) 
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FFE2 
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99 
FFE3: 
FFE3: 
FFE3: 
FFE3: 
FFE3: 
FFE4: 
FFE5: 
FFE6: 
FFE/: 
FFE8: 
FFE9: 
FFEA: 
FFEB: 
FFEC: 
FFED: 
FFEE: 
FFEF: 
FFFO: 
FFF1: 
FFF2: 
FFF3: 
FFF4: 
FFFS: 
FFF6: 
FFF7: 
FFF8: 
FFF9: 
FFFA: 
FFFA: 
FFFC: 
FFFE: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
C4C8: 
C4C8: 
C4C8: 
C4CB: 
C4CD: 
C4D0: 
C4D2: 
C4D5: 
C4D8: 
C4DA: 
C4DD: 
C4DF: 
C4El: 
C4E3: 
C4E5: 
C4E6: 


03 
FA 
C3 


C4C8 


731 DFB $99 ; BLANK 

732 * 

733 * Table of low order monitor routine dispatch 
734 * addresses. High byte always $FE 


735 * 

736 SUBTBL DFB >BASCONT-1 ;*C (BASIC warm start) 

737 DFB >USR-1 a 4 (not used) 

738 DFB >REGZ-1 ;*E (open and display registers) 
739 DFB >MINI-1 ;mini assembler 

740 DFB >VFY-1 3V (memory verify) 

741 DFB DINPRT-1 3K CIN#SLOT) 

742 DFB >SEARCH-1 ;search for pattern 

743 DFB >OUTPRT-1 ;7P (PR#SLOT) 

744 DFB >XBASIC-1 ;*B (BASIC cold start) 

745 DFB >SETMODE-1 ;'-' (subtraction) 

746 DFB >SETMODE-1 ;'+' (addition) 

747 DFB >MOVE-1 3M (memory move) 

748 DFB >LT-1 3'<' (delim for move,vfy) 
749 DFB >SETNORM-1 ;N (set normal video) 

750 DFB >SETINV-1 ;I (set inverse video) 

751 DFB >LIST-1 -1, (disassemble 20 instrs) 
752 DFB >WRITE-1 ;W (write to tape) 

753 DFB >GO-1 3G (execute program) 

754 DFB >READ-1 ;R (read from tape) 

755 DFB >SETMODE-1 ;':' (memory fill) 

756 DFB >SETMODE-1 ;'.' (address delimiter) 
757 DFB >CRMON-1 ;'CR' (end of input) 

758 DFB >BLANK-1 ;BLANK 

759 * 

760 DW NMI ; NON-MASKABLE INTERRUPT VECTOR 
761 DW RESET ;RESET VECTOR 

762 DW IRQ ; INTERRUPT REQUEST VECTOR 


INCLUDE MINI 
* 


* Apple //e Mini Assembler 
x 


* Got mnemonic, check address mode 


ORG C30ORG+$1C8 


cee eel oo ee on oo _ 


AMOD1 JSR NNBL ;get next non-blank 
STY YSAV ;save Y 
CMP CHARI ,X 
BNE AMOD2 
JSR NNBL ;get next non-blank 
CMP CHAR2,X 
BEQ AMOD3 
LDA CHAR2,X ;done yet? 
BEQ AMOD4 
CMP #SA4 sif "S" then done 
BEQ AMOD4 
LDY YSAV srestore Y 


20 AMOD2 CLC 
21 AMOD4 DEY 
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C4E7: 
C4E9: 
C4EB: 
C4ED: 
C4F0: 
C4F2: 
C4F4: 
C4F5: 
C4F7: 
C4F9: 
C4FA: 
C4FC: 
C4FD: 
C4FF: 
C500: 
CF3A: 
CF3A: 
CF3A: 
CF3A: 
CF3A: 
CF3C: 
CF3D: 
CF3F: 
CF41: 
CF43: 
CF45: 
CF46: 
CF47: 
CF48: 
CF49: 
CF4B: 
CF4D: 
CF4F: 
CF50: 
CF51: 
CF53: 
CF55: 
CF55: 
CF55: 
CF55: 
CF57% 
CF5SA: 
CFSC: 
CF5D: 
CF5F: 
CFF: 
CF5F: 
CF5F: 
CF62: 
CF65% 
CF68: 
CF6B: 
CFO6B: 
CF6B: 


48 
1A 
1A 
E3 


FF 


00 


F9 
FC 
FC 
FC 


C4FA 


C4F5 


C4c8 


CF3A 


CF53 


CE46 


CF50 


CF95 


CF5/ 


AMOD3 ROL 


ORG 
* 


* Calculate 
* 
REL SBC 
LSR 
BNE 
LDY 
LDX 
BNE 
DEY 
RELI DEX 
TXA 
CLC 
SBC 
STA 
BPL 
INY 
REL2 TYA 
SBC 
GOERR BNE 
x 


A5L sshift bit into format 


#$03 
AMOD6 
GETNUM 


A2H ;get high byte of address 


AMOD5 => 


YSAV1 
#$03 


AlH 


AMOD1 


C80RG+$73A 


offset byte for relative addresses 


#$81 ;calc relative address 


A 
GOERR ;bad branch 
A2H 
A2L 
RELI] 
;point to offset 


;displacement - 1 


PCL ssubtract current PCL 
A2L sand save as displacement 
REL2 ;check page 

sget page 
PCH ;check page 


MINIERR sdisplay error 


* Move instruction to memory 


* 

MOVINST LDY 

MOV1 LDA 
STA 
DEY 
BPL 


LENGTH ;get instruction 
Al1H,Y ;get a byte 
CPCL);Y 3;and move it 


MOVI1 


* Display instruction 


JSR 
JSR 
JSR 
JMP 


PRBLNK sprint blanks to 
UP ;move up 2 lines 
UP 

DISLIN ;disassemble it, 


length 


make ProDOS work 


=>DOINST 


* Compare disassembly of all known opcodes with 
* the one typed in until a match is found 
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CF6B: 
CF6B: 
CF6D: 
CF/70: 
CF71: 
CF74: 
CF/6: 
CF78: 
CF7B: 
CF/7D: 
CF/F: 
CF81: 
CF83: 
CF85: 
CF87: 
CF89: 
CF8B: 
CF8D: 
CF8F: 
CF91: 
CF93: 
CF95: 
CF95: 
CF95: 
CF95: 
CF95: 
298 
CF98: 
:4C 
CFIC: 

CFIC: 

CFIC: 

CF9C: 

CFIC: 

:20 
CF9F: 
:C9 


CF97 


CF99 


CF9C 


CFA2 


CFA4: 


CFA6 


CFAA 


CFAE 


CFBO 
CFB2 


CFB3: 
CFB5S: 
CFB5: 
CFB8: 
CFBA: 
CFBC: 
CFBF: 
:E9 


CFCO 


374 


AD 


FO 


2C9 
CFA8: 
:60 
CFAB: 
CFAB: 
:C9 
:DO 
:8A 


DO 


20 


FO 


20 
A9 
85 
20 
OA 


3D 
8E 


13 


OC 


34 


D2 


C7 
00 
AO 
12 
8D 
01 


A7 
93 
ES 


E2 
78 
03 
3D 
13 


BE 


F8 


FA 


CF8B 
F9 


CF8B 


CF3A 


CF55 


CF6B 


CF6B 


FC 


FF 
02 


CFB8 


CFAB 


FF 


CF97 


CF97 


FE 


FF 


76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
ew 
128 
129 


* 
GETOP 


NXTOP 


* + & 


& 


LDA 
JSR 
TAX 
LDA 
CMP 
BNE 
LDA 
CMP 
BNE 
LDA 
LDY 
CPY 
BEQ 
CMP 
BEQ 
DEC 
BNE 
INC 
DEC 
BEQ 


MINIERR LDY 


ERR2 


* 


* Read a line of input. 
* mnemonic. If 'S'" do monitor command. 


TYA 
TAX 
JMP 


AlH 
INSDS2 


MNEMR, X 
A4L 
NXTOP 
MNEML , X 
A4H 
NXTOP 
ASL 
FORMAT 
#S9D 
REL 
FORMAT 
MOVINST 
AlH 
GETOP 
ASL 
YSAVI 
GETOP 


YSAV 


ERR3 


;get opcode 
sdetermine mnemonic index 
3X = index 
;get right half of index 
sdoes it match entry? 
;=>try next opcode 
sget left half of index 
;does it match entry? 
;=>no, try next opcode 
;found opcode, check address mode 
sget addr. mode format for that opcode 
sis it relative? 
s=>yes, calc relative address 
;does mode match? 
;=>yes, move instruction to memory 
;@lse try next opcode 
3=>go try it 
;else try next format 


3=>go try next format 


Point to the error with a caret, beep, and fall 
into the mini-assembler. 


;get position 


sdisplay error, =>DOINST 


If prefaced with " ", decode 
Otherwise parse 


* hex address before decoding mnemonic. 


* 
DOINST 


* 
GETI1 


GOERR2 


JSR 
LDA 
CMP 
BEQ 
CMP 
BNE 
RTS 


JSR 
CMP 
BNE 
TXA 
BEQ 


JSR 
LDA 
STA 
JSR 
ASL 
SBC 


ZMODE 
$200 
#SAO 
DOLIN 
#$ 8D 
GETI1 


GETNUM 
#$93 
ERR2 


ERR2 


Al PCLP 
#$03 
AlH 
NNBL 

A 
#SBE 


sclear mode 

sget first char in line 
;if blank, 

;=>go attempt disassembly 
sis it return? 

3=>no, continue 

selse return to Monitor 


;parse hexadecimal input 
slook for "ADDR:" 

sno ":", display error 

;X nonzero if address entered 
sno "ADDR", display error 


smove address to PC 
;get starting opcode 
;and save 

;get next non-blank 
svalidate entry 
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CFC2: 
CFC4: 
CrC6: 
CFC6: 
CFC6: 
CFC6: 
CFC?7: 
CFC8: 
CFCA: 
CFCB: 
CFCD: 
CFCF: 
CFDO: 
CFD2: 
CFD4: 
CFD6: 
CFD8: 
CFDA: 
CFDD: 
CFDF: 
CFEO: 
CFE1: 
CFE3: 
CFE5: 
CFE/7: 
CFE9: 
CFEB: 
CFED: 
CFEF: 
CFF1: 
CFF4: 
CFF6: 
CFF8: 
CFFA: 
CFFC: 
CFFF: 
CFFF: 


C2 
Dl 


C8 C4 


CF9/ 


CFCA 


CFCA 
CF BC 


CFED 


CFED 


130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 


* 


CMP 
BCC 


#$C2 
ERR2 


3;=>flag bad mnemonic 


* Form mnemonic for later comparison 


* 


NXTMN 


AMOD/7 


AMOD8 
* 


ASL 
ASL 
LDX 
ASL 
ROL 
ROL 
DEX 
BPL 
DEC 
BEQ 
BPL 


NXTCH 
#$5 
AMOD1 
A5L 

A 

A 
YSAV1 
#$20 
AMOD/ 
YSAV1 
AMOD7 
#$80 
ASL 
YSAV 
$0200,Y 
#SBB 
AMOD8 
#$8D 
GOERR2 
GETOP 


$00 


;decrement mnemonic count 


;index into address mode tables 
;do this elsewhere 
;get format 


;get our format 


;update format 

;update position 

;get next character 
sis it a ‘':'"? 

;=>yes, skip comment 
;is it carriage return 


;get next opcode 


sbyte for making CTOD checksum ok 
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Glossary 


accumulator: The register in the 
65C02 microprocessor where most 
computations are performed. 


ACIA: Acronym for Asychronous 
Communications Interface 
Adapter. The ACIA is a chip that 
converts data from parallel to serial 
form and vice versa. Its internal 
registers control and keep track of 
the sending and receiving of data. 
Firmware and software set and 
change the status of these internal 
registers. 


acronym: A word formed from the 
initial letters of a name or phrase, 
such as ROM, from read-only 
memory. 


address: A number that specifies a 
single byte of memory. Addresses 
can be given as decimal integers or 
as hexadecimal integers. A 64K 
system has addresses ranging from 
0 to 65535 (in decimal) or from 
$0000 to $FFFF (iin hexadecimal). 


algorithm: A step-by-step 
procedure for solving a problem or 
accomplishing a task. 


analog: Represented in terms of a 
physical quantity that can vary 
smoothly and continuously over a 


range of values. For example, a 
conventional 12-hour clock face is 
an analog device that represents the 
time of day in terms of the angles of 
the clock’s hands. Compare digital. 


analog data: Data in the form of 
continuously variable physical 
quantities. Compare digital 
data. 


analog signal: A signal that varies 
continuously over time. 


analog-to-digital converter: A 
device that converts quantities from 
analog to digital form. For example, 
hand controls used on Apple II 
family computers convert the 
position of the control dial (an 
analog quantity ) into a discrete 
number (a digital quantity) that 
changes abruptly even when the 
dial is turned smoothly. 


AND: A logical operator that 
produces a true result if both of its 
operands are true, a false result if 
either or both of its operands are 
false; compare OR, exclusive OR, 
NOT. 


ANSI: Acronym for American 
National Standards /nstitute, 
which sets standards for many 
fields and is the most common 
standard for terminals. 
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Apple IIe: A transportable 
personal computer in the Apple II 
family, with a disk drive and 
80-column capability built in. 


Apple IIe: A personal computer in 
the Apple II family. 


Apple IIe 80-Column Text Card: 
A peripheral card that plugs into the 
Apple Ile’s auxiliary slot and 
converts the computer’s display of 
text from 40-column width to 
80-column width. 


Apple IIe Extended 80-Column 
Text Card: A peripheral card that 
plugs into the Apple Ile’s auxiliary 
slot and converts the computer's 
display of text from 40-column 
width to 80-column width while 
extending its memory capacity by 
64K bytes. 


Apple II Pascal: A software 
system that lets you create and 
execute programs written in the 
Pascal programming language, 
adapted by Apple Computer from 
the UCSD (University of California, 
San Diego) Pascal Operating System 
and sold for use with the Apple II 
family of computers. 
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Applesoft BASIC: An extended 
version of the BASIC programming 
language used with the Apple II 
family of computers. An interpreter 
for creating and executing programs 
in Applesoft is built into the 
computer’s firmware. Compare 
Integer BASIC. 


application program: A program 
that puts the resources and 
capabilities of the computer to use 
for some specific purpose or task, 
such as word processing, data base 
management, or graphics. Compare 
system program. 


argument: The value on which a 
function operates. 


arithmetic expression: A 
combination of numbers and 
arithmetic operators (such as 

3+ 5) that indicates some operation 
to be carried out. 


arithmetic operator: An 
operator, such as +, that combines 
numeric values to produce a 
numeric result. Compare 
relational operator, logical 
operator. 


ASCII: Acronym for American 
Standard Code for Information 
Interchange, pronounced ASK ee. 
A code in which the numbers from 0 
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to 127 stand for text characters— 
including the letters of the alphabet, 
the digits 0 through 9, punctuation 
marks, special characters, and 
control characters—used for 
representing text inside a computer 
and for transmitting text between 
computers or between a computer 
and a peripheral device. 


assembler: A language translator 
that converts a program written in 
assembly language into an 
equivalent program in machine 
language. 


assembly language: A low-level 
programming language in which 
individual machine-language 
instructions are written ina 
symbolic form more easily 
understood by a human programmer 
than machine language itself. 


asserted: Made true (positive in 
positive-true logic; negative in 
negative-true logic). 


asynchronous transmission: 

Not synchronized by or with a 
clocking signal. Transmission in 
which each information character is 
individually synchronized, usually 
by the use of start and stop bits. The 
gap between each character isn't 
necessarily fixed. Compare 
synchronous transmission. 
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auxiliary slot: The special 
expansion slot inside the Apple Ile 
used for the Apple 80-Column Text 
Card or Extended 80-Column Text 
Card. 


base address: In indexed 
addressing, the fixed component of 
an address. 


BASIC: Acronym for Beginner’s 
All-purpose Symbolic Instruction 
Code. A high-level programming 
language designed to be easy to 
learn and use. Two versions of 
BASIC are available from Apple 
Computer for use with all Apple II 
family systems: Applesoft (built into 
firmware) and Integer BASIC 
(provided on the ProDOS User's 
Disk). 


baud: Unit of signaling speed taken 
from the name Baudot. The speed in 
bauds is equal to the num ber of 
discrete conditions or sigmal events 
per second regardless of tIhe 
information content of those signals. 
Often equated (though not 
precisely ) with bits per second. 
Compare bit rate. 


binary: The representation of 
numbers in terms of powers of two, 
using the two digits 0 and 1. 
Commonly used in computers 
because the values 0 and 1 can 
easily be represented in physical 
form in a variety of ways, such as 
the presence or absence of current, 
positive or negative voltage, or a 
white or black dot on the display 
screen. A single binary digit—a 0 or 
a 1—is called a bit. 


binary digit: The smallest unit of 
information in the binary number 
system. Also called a bit. 


binary operator: An operator that 
combines two operands to produce a 
result; for example, + is a binary 
arithmetic operator, < 1s a binary 
relational operator, and OF is a 
binary logical operator. Compare 
unary operator. 


bit: The smallest item of useful 
information a computer can handle. 
Usually represented as a 1 or a0. 
Eight bits equal one byte. 


bit rate: The speed at which bits 
are transmitted, usually expressed 
as bps or bits per second. 
Compare baud. 


board: See printed-circuit 
board. 


body: The statements or 
instructions that make up a part of a 
program, such as a loop ora 
subroutine. 


boot: To start up a computer by 
loading a program into memory 
from an external storage medium 
such as a disk. Often accomplished 
by first loading a small program 
whose purpose is to read the larger 
program into memory. The program 
is said to pull ztselfup by its own 
bootstraps—hence the term 
bootstrapping or booting. 


boot disk: See startup disk. 
bootstrap: See boot. 
bps: See bit rate. 


branch: To send program 
execution to a line or statement 
other than the next in sequence. 


BREAK: A SPACE (0) signal, sent 
over a communication line, of long 
enough duration to interrupt the 
sender. This signal is often used to 
end a session with a time-sharing 
service. 


BRK: An instruction that causes 
the 65C02 microprocessor to halt. 
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buffer: A memory area that holds 
information until it can be 
processed. 


bug: An error in a program that 
causes it not to work as intended. 


bus: A group of wires that transmit 
related information from one part of 
a computer system to another. 


byte: A sequence of eight bits that 
represents an instruction, a letter, a 
number, or a punctuation mark. 


cable: A group of wires used to 
carry information between two 
devices. How many wires are used 
varies with the type of connection. 


call: To request the execution of a 
subroutine or function. 


card: See peripheral card. 


carriage return: An ASCII 
character (decimal 13) that 
ordinarily causes a printer or 
display device to place the 
subsequent character on the left 
margin. 


carrier: The background signal on 
a communication channel that is 
modified to carry the information. 
Under RS282-C rules, the carrier 
signal is equivalent to a continuous 
MARK (1) signal; a transition to 0 
then represents a start bit. 
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carry flag: A status bit in the 
65C02 microprocessor, used to hold 
the high-order bit (the carry bit) in 
addition and subtraction. 


central processing unit: See 
processor. 


character: Any symbol that has a 
widely understood meaning. Some 
characters—such as letters, 
numbers, and punctuation—can be 
displayed on the monitor screen and 
printed on a printer. Others are used 
to control various functions of the 
computer. See control character. 


character code: A number used to 
represent a text character for 
processing by a computer system. 


character set: The entire set of 
characters that can be either shown 
on a monitor or used to code 
computer instruction. In a printer, 
the entire set of characters that the 
printer is capable of printing. 


circuit board: A collection of 
integrated circuits (chips) on a 
board. 


Clear To Send: An RS232-C signal 
from a DCE to a DTE that is 
normally kept false until the DCE 
makes it true, indicating that all 
circuits are ready to transfer data 
out. 
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code: (1) A number or symbol used 
to represent some piece of 
information in a compact or easily 
processed form. (2) The statements 
or instructions making up a 
program. 


cold start: The process of starting 
up the Apple II when the power is 
first turned on (or as if the power 
had just been turned on ) by loading 
the operating system into main 
memory, then loading and running a 
program. 


column: A vertical arrangement of 
graphics points or character spaces 
on the monitor screen. 


command: A word or character 
that causes the computer to do 
something. 


compiler: A language translator 
that converts a program written in a 
high-level programming language 
into an equivalent program in some 
lower-level language (Such as 
machine language) for later 
execution. Compare interpreter. 


composite video: A video signal 
that includes both display 
information and the synchronization 
(and other) signals needed to 
display it. 
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computer: An electronic device 
that performs predefined 
(programmed) computations at high 
speed and with great accuracy. A 
machine that is used to store, 
transfer, and transform information. 


computer language: See 
programming language. 


computer system: A computer 
and its associated hardware, 
firmware, and software. 


conditional branch: A branch 
that depends on the truth of a 
condition or the value of an 
expression. Compare 
unconditional branch. 


configuration: The hardware and 
software arrangement of a system. 


connector: A physical device such 
as a plug, socket, or jack, used to 
connect two devices to one another. 


console: The Apple Ile’ s video 
display and keyboard together make 
up the console. This is the part of 
the Apple Ile you communicate with 
directly. 


constant: A symbol in a program 
that represents a fixed, unchanging 
value. Compare variable. 


(CONTROL |}: A key that when 
pressed in conjunction with another 
key makes that other key behave 
differently. 


[CONTROL }{RESET }: This 
combination of keystrokes usually 
causes an Applesoft program or 
command to stop immediately. If a 
program disables the 

feature, you 
need to turn the computer off to get 
the program to stop. 


control character: A non-printing 
character that controls or modifies 
the way information is printed or 
displayed. Control characters have 
ASCII values between 0 and 31, and 
are typed from a keyboard by 
holding down while 
pressing some other key. For 
example, the character Control-M 
(ASCII code 13) means “return to 
the beginning of the line” and is 
equivalent to pressing (RETURN }. 


control code: One or more 
non-printing characters included in 
a text file whose function Is to 
change the way a printer prints the 
text. See control character. 


controller card: A peripheral card 
that connects a device such as a 
printer or disk drive to an Apple IIe 
and controls the operation of the 
device. 


copy-protect: To prevent someone 
from duplicating the contents of a 
disk. Compare write-protect. 


CPU: Abbreviation for central 
processing unit. See processor. 


current input device: The source, 
such as the keyboard or a modem, 
from which a program is currently 
receiving its input. 


current output device: The 
destination, such as the display 
screen or a printer, to which a 
program is currently sending its 
output. 


cursor: A symbol displayed on the 
screen that marks where the user’s 
next action will take effect or where 
the next character typed from the 
keyboard will appear. 


DAC: See digital-to-analog 
converter. 


data: Information, especially raw 
or unprocessed information, used or 
operated on by a program. 
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data bits: The computer sends 
and receives information as a string 
of bits. These are called data bits. 


Data Carrier Detect: An RS232-C 
signal from a DCE (such as a 
modem) to a DTE (such as an 

Apple Ile) indicating that a 
communication connection has 
been established. 


Data Communication 
Equipment: As defined by the 
RS232-C standard, any device that 
transmits or receives information. 
Usually this is a modem. However, 
when a modem eliminator is used, 
the Apple Ile itself looks like a DCE 
to the other device, and the other 
device looks like a DCE to the 
Apple Ile. 


data set: A device that performs 
the modulation/demodulation 
control functions necessary to 
provide the compatibility between 
business machines and 
communications facilities. See 
modem. 


Data Set Ready: An RS232-C 
signal from a DCE to a DTE 
indicating that the DCE has 
established a connection. 


381 


Data Terminal Equipment: As 
defined by the RS2382-C standard, 
any device that generates or absorbs 
information, thus acting as a 
terminus of a communication 
connection. 


Data Terminal Ready: An 
RS232-C signal from a DTE to a DCE 
indicating a readiness to transmit or 
receive data. 


DCD: See Data Carrier Detect. 


DCE: See Data Communication 
Equipment. 


debug: To locate and correct an 
error or the cause of a problem or 
malfunction in a computer system. 
Typically used to refer to 
software-related problems. Compare 
troubleshoot. 


decimal: The common form of 
number representation used in 
everyday life, in which numbers are 
expressed in terms of powers of ten, 
using the ten digits 0 through 9. 


default: A value, action, or setting 
that is assumed or set in the 
absence of explicit instructions 
otherwise. 
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deferred execution: The saving 
of an instruction in a program for 
execution at a later time as part of a 
complete program; occurs when the 
statement is typed with a line 
number. Compare immediate 
execution. 


(DELETE |: A key on the upper-right 
corner of the Apple Ile and IIc 
keyboards that, when pressed, 
usually erases the character 
immediately preceding the cursor. 


delimiter: A character that is used 
to mark the beginning or end of a 
sequence of characters, and which 
therefore is not considered part of 
the sequence itself. For example, 
Applesoft uses the double quotation 
mark () as a delimiter for string 
constants: the string DOG consists 
of the three characters D, O, and G, 
and does not include the quotation 
marks. In written English, the space 
character is used as a delimiter 
between words. 


demodulate: To recover the 
information being transmitted by a 
modulated signal; for example, a 
conventional radio receiver 
demodulates an incoming broadcast 
signal to convert it into sound 
emitted by a speaker. 
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device: A piece of computer 
hardware—such as a disk drive, a 
printer, or a monitor—other than 
the computer itself. Devices may be 
built in or peripheral. 


device driver: A program that 
manages the transfer of information 
between the computer and a 
peripheral device. 


device handler: See device 
driver. 


digit: (1) One of the char acters 0 
through 9, used to express numbers 
in decimal form. (2) One of the 
characters used to express numbers 
in some other form, such as 0 and 1 
in binary or 0 through 9 and A 
through F in hexadecimal. 


digital: Represented in a discrete 
(noncontinuous) form, such as 
numerical digits. For exarnple, 
contemporary digital clocks display 
the time in numerical forrn (such as 
2:57) instead of using the positions 
of a pair of hands on a clock face. 
Compare analog. 


digital data: Data that can be 
represented by digits—that is, data 
that are discrete rather than 
continuously variable. Compare 
analog data. 


digital-to-analo g converter: A 
device that converts quantities from 
digital to analog form. 


DIP: See dual in-line package. 


DIP switch: A bank of tiny 
switches, each of which can be 
moved manually one way or the 
other to represent one of two values 
(usually on and off). 


disassembler: A language 
translator that converts a 
machine-language program into an 
equivalent prograrn in assembly 
language, more easily understood by 
a human programrner. The opposite 
of an assembler. 


disk: An information-storage 
medium consisting of a flat, 
circular, magnetic surface on which 
information can be recorded in the 
form of small magnetized spots, in a 
manner similar to the way sounds 
are recorded on tape. 


disk controller card: A circuit 
board that provides the connection 
between one or two disk drives and 
the Apple Ile. 


disk drive: A device that reads 
information from disks into the 
memory of the com puter and writes 
information from the memory of the 
computer onto a disk. 


disk envelope: A removable 
protective paper sleeve used when 
handling or storing a disk. It must be 
removed before inserting the disk in 
a disk drive. Compare disk jacket. 


diskette: A term sometimes used 
for the small (54-inch), flexible 
disks on which information is 
stored. 


disk jacket: A permanent 
protective covering for a disk, 
usually made of black paper or 
plastic. The disk is never removed 
from the jacket, even when inserted 
in a disk drive. Compare disk 
envelope. 


disk operating system: One of 
several optional software systems 
for the Apple II family of computers 
that enables the computer to control 
and communicate with one or more 
disk drives. 


Disk II drive: One of a number of 
types of disk drive made and sold by 
Apple Computer for use with the 
Apple II family of computers. It uses 
54-inch flexible (floppy) disks. 


disk-resident: Stored or held 
permanently on a disk. 
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display: v. To exhibit information 
visually. 7. (1) Information 
exhibited visually, especially on the 
screen of a display device, such as a 
video monitor. (2) A display device. 


display color: The color currently 
being used to draw high-resolution 
or low-resolution graphics on the 
display screen. 


display device: A device that 
exhibits information visually, such 
as a television set or video monitor. 


DOS 3.2: Anearly Apple II 
operating system. DOS stands for 
Disk Operating System. 3.2 is the 
version number. 


DOS 3.3: One of the operating 
systems used by the Apple II family 
of computers. DOS stands for Disk 
Overating System. 3.3 is the 
version number. 


drive: See disk drive. 
DSR: See Data Set Ready. 


DTE: See Data Terminal 
Equipment. 


DTR: See Data Terminal Ready. 
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dual in-line package: An 
integrated circuit packaged in a 
narrow rectangular box with a row 
of metal pins along each side. Often 
referred to as a DIP switch. 


Dvorak keyboard: An alternate 
keyboard layout, also known as the 
simplified keyboard. 


effective address: In 
machine-language programming, 
the address of the memory location 
on which a particular instruction 
actually operates, which may be 
arrived at by indexed addressing or 
some other addressing method. 


80-column text card: A circuit 
board that converts the computer's 
display of text from 40 columns to 
80 columns. 


80/40 column switch: A switch, 
either hardware or software, that 
controls the number of horizontal 
columns or characters across your 
screen. A television can display a 
maximum of 40 characters across, 
while a video monitor can display 80 
characters across the screen. 


embedded: Contained within. For 
example, the string 
HUMPTY DUMPTY is Said to contain 
an embedded space. 
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emulate: To behave in an identical 
way. The Apple II 2780 /3780 
Protocol Emulator and the Apple I] 
3270 BSC Protocol Emulator, for 
example, allow your Apple II, Il 
Plus, or Ile, together with the Apple 
Communications Protocol Card 
(ACPC), to emulate the operations 
of IBM 3278 and 3277 terminals and 
3274 and 3271 control units. 


end-of-command mark: A 
punctuation mark used to separate 
commands sent to a peripheral 
device such as a printer or plotter. 
Also called a command 
terminator. 


end-of-line character: Any 
character that tells the printer that 
the preceding text constitutes a full 
line and may now be printed. 


error code: A number or other 
symbol representing a type of error. 


error message: A message 
displayed or printed to notify the 
user of an error or problem in the 
execution of a program. 


Escape character: An ASCII 
character that allows you to perform 
special functions when used in 
combination keypresses. 
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escape mode: A state of the 
computer, entered by press ing 
[Esc], in which certain keys on the 
keyboard take on special meanings 
for positioning the cursor and 
controlling the display of text on the 
screen. 


escape sequence: A sequence of 
keystrokes, beginning with [ESC], 
used for positioning the cursor and 
controlling the display of text on the 
screen. 


even parity: Use of an extra bit set 
to 0 or 1 as necessary to make the 
total number of 1 bits (among the 
data bits plus the parity bit) an even 
number. 


even/odd parity check: A check 
that tests whether the nurmber of 
digits in a group of binary digits is 
even (even parity check) or odd 
(odd parity check). 


exclusive OR: A logical operator 
that produces a true result if one of 
its operands is true and the other 
false, a false result if its operands 
are both true or both false. Compare 
OR, AND, and NOT. 


execute: To perform the actions 
specified by a program command or 
sequence of commands. 


expansion slot: A connector 
inside the Apple Ife in which a 
peripheral card can be installed. 
sometimes called a peripheral 
slot. 


expression: A formula ina 
program that describes a calculation 
to be performed. 


FIFO: First in, first out. 


file: An ordered collection of 
information stored as a named unit 
on a peripheral storage medium 
such as a disk. 


firmware: Software stored 
permanently in hardware: programs 
in read-only memory (ROM). Such 
programs (for example, the 
Applesoft Interpreter and the 
Monitor program) are built into the 
computer at the factory. They can 
be executed at any time but cannot 
be modified or erased from main 
memory. Compare hardware, 
software. 


fixed-point: A method of 
representing numbers inside the 
computer in which the decimal 
point (more correctly, the binary 
point) is considered to occur at a 
fixed position within the number. 
Typically, the point is considered to 


lie at the right end of the number so 
that the number is interpreted as an 
integer. Compare floating-point. 


flag: A variable whose contents 
(usually 1 or 0, standing for trwe or 


false) indicate whether some 


condition holds or whether some 
event has occurred. Used to control 
the program’s actions at some later 
time. 


flexible disk: A disk made of 
flexible plastic. Often called a 
floppy disk. Compare rigid disk. 


floating-point: A method of 
representing numbers inside the 
computer in which the decimal 
point (more correctly, the binary 
point) is permitted to float to 
different positions within the 
number. Some of the bits within the 
number itself are used to keep track 
of the point’s position. Compare 
fixed-point. 


floppy disk: See flexible disk. 


format: 7. The form in which 
information is organized or 
presented. v. (1) To specify or 
control the format of information. 
(2) To prepare a blank disk to 
receive information by dividing its 
surface into tracks and sectors. Also 
initialize. 
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form feed: An ASCII character 
(decimal 12) that causes a printer or 
other paper-handling device to 
advance to the top of the next page. 


FORTRAN: A contraction of the 
phrase FORmula TRANslator. A 
widely used, high-level 
programming language especially 
suitable for applications requiring 
extensive numerical calculations, 
such as in mathematics, 
engineering, and the sciences. A 
version called Apple II Fortran is 
sold by Apple Computer for use with 
the Apple II Pascal Operating 
System. 


framing error: In serial data 
transfer, absence of the expected 
stop bit(s) at the end of a received 
character. 


frequency: The number of 
complete cycles transmitted per 
second. Usually expressed in hertz 
(cycles per second), kilohertz 
(kilocycles per second), or 
megahertz (megahertz per second). 


full duplex: Capable of 
simultaneous, two-way 
communication. Compare half 
duplex. 
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function: A pre-programmed 
calculation that can be carried out 
on request from any point in a 
program. An instruction that 
converts data from one form to 
another. 


GAME I/O connector: A special 
16-pin connector inside the 

Apple Ile originally designed for 
connecting hand controls to the 
computer, but also used for 
connecting some other peripheral 
devices. Compare hand-control 
connector. 


graphics: (1) Information 
presented in the form of pictures or 
images. (2) The display of pictures 
or images on a computer’s video 
display screen. Compare text. 


half duplex: Capable of 
communication in only one 
direction at a time. Compare full 
duplex. 


hand-control connector: A 9-pin 
connector on the back panel of the 
Apple Ile, used for connecting hand 
controls to the computer. Compare 
GAME I/0 connector. 
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hand controls: Optional 
peripheral devices, with rotating 
dial and pushbuttons, that can be 
connected to the Apple Ile hand 
control connector. Typically used to 
control game-playing programs, but 
can be used in more serious 
applications as well. 


hang: For a program or system to 
spin its wheels indefinitely, 
performing no useful work. 


hardware: The physical 
machinery that makes up a 
computer system. Compare 
firmware, software. 


hertz: The unit of frequency of 
vibration or oscillation, also called 
cycles per second. Named for the 
physicist Heinrich Hertz and 
abbreviated Hz. The 65C02 
microprocessor used in the Apple Ile 
operates at a clock frequency of 1 
million hertz, or 1 megahertz (MHz). 


hexadecimal: The representation 
of numbers in terms of powers of 
sixteen, using the ten digits 0 
through 9 and the six letters A 
through F. Hexadecimal numbers 
are easier for humans to read and 
understand than binary numbers, 
but can be converted easily and 
directly to binary form. Each 
hexadecimal digit corresponds to a 
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sequence of four binary digits, or 
bits. Hexadecimal numbers are 
preceded by a dollar sign C$). 


high ASCII characters: ASCII 
characters with decimal walues of 
128 to 255. Called hagh ASCII 
because their high bit (first binary 
digit) is set to 1 (for ov) rather than 
0 (for off). 


high-level language: A 
programming language that is 
relatively easy for humans to 
understand. A single statement in a 
high-level language typically 
corresponds to several instructions 
of machine language. High-level 
languages available for the Apple Ile 
include BASIC, Pascal, Logo, and 
PILOT. 


high-order byte: The more 
significant half of a memory address 
or other two-byte quantity. In the 
65C02 microprocessor, the low-order 
byte of an address is usually stored 
first, and the high-order byte 
second. 


high-resolution graplnics: The 
display of graphics on a display 
screen as a $i1x-color array of points, 
280 columns wide and 192 rows 
high. When the text window is in 
use, the visible high-resolution 
graphics display is 280 by 160 
points. 


hold time: In computer circuits, 
the amount of time a signal must 
remain valid after some related 
signal has been turned off. Compare 
setup time. 


Hz: See hertz. 
IC: See integrated circuit. 


immediate execution: The 
execution of an program instruction 
as soon as it is typed. Occurs when 
the line is typed without a line 
number. This means that you can 
try out nearly every statement 
immediately to see how it works. 
Compare deferred execution. 


implement: To realize or bring 
about; for example, a language 
translator implements a particular 
language. 


IN#: This command designates 
the source of subsequent input 
characters. It can be used to 
designate a device in a slot or a 
machine-language routine as the 
source of input. 


index: (1) A number used to 
identify a member of a list or table 
by its sequential position. (2) A list 
or table whose entries are identified 
by sequential position. (8) In 
machine-language programming, 
the variable component of an 


indexed address, contained in an 
index register and added to the base 
address to form the effective 
address. 


indexed addressing: A method of 
specifying memory addresses used 
in machine-language programming. 


index register: A register in a 
computer processor that holds an 
index for use in indexed addressing. 
The 65C02 has two index registers, 
the X register and the Y register. 


index variable: A variable whose 
value changes on each pass through 
a loop. Often called control 
variable or loop variable. 


infinite loop: A section of a 
program that will repeat the same 
sequence of actions indefinitely. 


initialize: (1) To set to an initial 
state or value in preparation for 
some computation. (2) To prepare a 
blank disk to receive information by 
dividing its surface into tracks and 
sectors. Also format. 


initialized disk: A disk that is 
organized into tracks and sectors. 


input: Information transferred into 
a computer from some external 
source, such as the keyboard, a disk 
drive, or a modem. 
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input/output: Abbreviated I/O. 
The means by which information is 
transferred between the computer 
and its peripheral devices. 


input routine: A 
machine-language routine that 
performs the reading of characters. 
The standard input routine reads 
characters from the keyboard. A 
different input routine might, for 
example, read them from an 
external terminal. 


instruction: A unit of a 
machine-language or 
assembly-language program 
corresponding to a single action for 
the computer’s processor to 
perform. 


integer: A whole number 
represented inside the computer in 
fixed-point form. Compare real 
number. 


Integer BASIC: A version of the 
BASIC programming language used 
by the Apple II family of computers. 
Integer BASIC is older than 
Applesoft and capable of processing 
numbers in integer (fixed-point) 
form only. Compare Applesoft 
BASIC. 
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integrated circuit: Networks of 
microfine wire that conduct 
electrical impulses. They are etched 
on silicon wafers and embedded in 
black plastic. 


interface: The devices, rules, or 
conventions by which one 
component of a system 
communicates with another. 


interface card: A peripheral card 
that implements a particular 
interface (such as a parallel or serial 
interface) by which the computer 
can communicate with a peripheral 
device such as a printer or modem. 


interpreter: A language translator 
that reads a program instruction by 
instruction and immediately 
translates each instruction for the 
computer to carry out. Compare 
compiler. 


interrupt: A temporary 
suspension in the execution of a 
program by a computer in order to 
perform some other task, typically 
in response to a signal from a 
peripheral device or other source 
external to the computer. 
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inverse video: The display of text 
on the computer’s display screen in 
the form of dark dots on a light (or 
other single phosphor color) 
background, instead of the usual 
light dots on a dark background. 


1/0: Input/output. The transfer of 
information into and out of a 
computer. See input, output. 


1/0 device: Input/output device. 
A device that transfers information 
into or out of a computer. See input, 
output, peripheral device. 


I/O link: A fixed location that 
contains the address of an 
input/output subroutine in the 
computer’s Monitor program. 


joystick: An accessory that moves 
creatures and objects in game 
programs. 


K: Two to the tenth power, or 1024 
(from the Greek root Az/o, meaning 
one thousand); for example, 64K 
equals 64 times 1024, or 65,536. 


keyboard: The set of keys built 
into the Apple Ile, similar to a 
typewriter keyboard, used for 
entering information into the 
computer. 
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keyboard input connector: The 
special connector inside the 
Apple Ie by which the keyboard is 
connected to the computer. 


keystroke: The act of pressing a 
single key or a combination of keys 


(such as [CONTROL HC ]) on the 
keyboard. 


keyword: A special word or 
sequence of characters that 
identifies a particular type of 
statement or command, such as 
RUN or PRINT. 


kilobyte: A unit of information 
consisting of 1K (1024) bytes, or 8K 
(8192) bits. See K. 


KSW: The symbolic name of the 
location in the computer’s memory 
where the standard input link is 
stored. ASW stands for keyboard 
switch. See 1/0 link. 


language: See programming 
language. 


leading zero: A zero occurring at 
the beginning of a number, deleted 
by most computing programs. 


least significant bit: The 
right-hand bit of a binary number as 
written down. Its positional value is 
Qor 1. 


LIFO: Acronym for last in, first 
out. 


line feed: An ASCII character 
(decimal 10) that ordinarily causes 
a printer or video display to advance 
to the next line. 


line number: A number 
identifying a program line in an 
Applesoft program. Line numbers 
are necessary for deferred 
execution. 


line width: The number of 
characters that fit on a line on the 
screen or on a page. 


list: A verb in cornputer jargon, 
meaning to display on a monitor, or 
print on a printer, the contents of 
the computer memory or a file. 


load: To transfer information from 
a peripheral storage medium (such 
as a disk) into main memory for use; 
for example, to transfer a program 
into memory for execution. 


location: See me mory location. 


logic board: See main logic 
board. 


logical operator: An operator, 
such as AND, that combines logical 
values to produce a logical result. 
Compare arithmetic operator, 
relational operator. 


loop: A section of a program that is 
executed repeatedly until a limit or 
condition is met, such as an index 
variable reaching a specified ending 
value. 


loop variable: See index 
variable. 


low-level language: A 
programming language that is 
relatively close to the form that the 
computer's processor can execute 
directly. Low-level languages 
available for the Apple Ile include 
6502 machine language and 6502 
assembly language. 


low-order byte: The less 
significant half of a memory address 
or other two-byte quantity. In the 
65C02 microprocessor, the low-order 
byte of an address is usually stored 
first, and the high-order byte 
second. 


low-power Schottkey: A type of 
TTL integrated circuit having lower 
power and higher speed than a 
conventional TTL integrated circuit. 
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low-resolution graphics: The 
display of graphics on a display 
screen as a sixteen-color array of 
blocks, 40 columns wide and 48 
rows high. When the text window is 
in use, the visible low-resolution 
graphics display is 40 by 40 blocks. 


LS: See low-power Schottkey. 


machine language: The form in 
which instructions to a computer 
are stored in memory for direct 
execution by the computer’s 
processor. Each model of computer 
processor (such as the 65C02 
microprocessor used in the 

Apple Ile) has its own form of 
machine language. 


main logic board: A large circuit 
board that holds RAM, ROM, the 
microprocessor, custom-integrated 
circuits, and other components that 
make the computer a computer. 


main memory: The memory 
component of a computer system 
that is built into the computer itself 
and whose contents are directly 
accessible to the computer. 


MARK parity: A bit of value 1 
appended to a binary number for 
transmission. The receiving device 
can then check for errors by looking 
for this value on each character. 
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mask: A pattern of bits for use in 
bit-level logical operations. 


memory: A hardware component 
of a computer system that can store 
information for later retrieval. See 
main memory, random-access 
memory, read-only memory, 
read-write memory. 


memory location: A unit of main 
memory that is identified by an 
address and can hold a single item 
of information of a fixed size. In the 
Apple IIe, a memory location holds 
one byte, or eight bits, of 
information. 


memory-resident: (1) Stored 
permanently in main memory as 
firmware. (2) Held continually in 
main memory even while not in use. 
DOS is memory resident. 


menu: A list of choices presented 
by a program, usually on the display 
screen, from which the user can 
select. 


MHz: Megahertz; one million hertz. 
See hertz. 


microcomputer: A computer, 
such as any of the Apple II family of 
computers, whose processor is a 
microprocessor. 
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microprocessor: A computer 
processor contained in a single 
integrated circuit, such as the 65C02 
microprocessor used in the 

Apple Ile. 


microsecond: One millionth of a 
second. Abbreviated ps. 


millisecond: One thousandth of a 
second. Abbreviated ms. 


mode: A state of a computer or 
system that determines its behavior. 
A manner of operating. 


modem: Acronym for 
MOdulator/DEModulator; a 
peripheral device that enables the 
computer to transmit and receive 
information over telephone lines by 
converting digital signals to analog 
signals, and vice-versa. 


modulate: To modify or alter a 
signal so as to transmit information. 
For example, conventional 
broadcast radio transmits sound by 
modulating the amplitude 
(amplitude modulation, or AM) or 
the frequency (frequency 
modulation, or /’M/) of a carrier 
signal. 


monitor: See video monitor. 
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Monitor program: A system 
program built into the firm ware of 
the Apple Ile, used for directly 
inspecting or changing the contents 
of main memory and for operating 
the computer at the 
machine-language level. 


most significant bit: The 
leftmost bit of a binary number as 
written down. This bit represents 0 
or | times 2 to the power one less 
than the total number of bits in the 
binary number. For example, in the 
binary number 10000, which 
contains five digits, the / represents 
1 times two to the fourth power—or 
sixteen. 


mouse: A small device that you 
roll around on a flat surface next to 
your Apple II family system. A 
small pointer on the screen tracks 
the movement of the mouse. 


nanosecond: One billionth (in 
British usage, one thousand- 
millionth) of a second. Abbreviated 
NS. 


nested loop: A loop contained 
within the body of another loop and 
executed repeatedly during each 
pass through the containing loop. 


nested subroutine call: A call to 
a subroutine from. within the body 
of another subrou tine. 


nibble: A unit of information equal 
to half a byte, or four bits. A nibble 
can hold any value from 0 to 16. 
Sometimes spelled nybble. 


NOT: A unary logical operator that 
produces a true result if its operand 
is false, a false res ult if its operand 
is true. Compare AND, OR, 
exclusive OR. 


NTSC: (1) Abbreviation for 
National Televiszon Standards 
Committee. The committee that 
defined the standard format used 
for transmitting broadcast video 
signals in the United States. (2) The 
standard video format defined by 
the NTSC. 


object code: See object 
program. 


object program: The translated 
form of a program produced by a 
language translator such as a 
compiler or assembler. Also called 
object code. Compare source 
program. 


odd parity: Use of an extra bit set 
to 0 or 1 as necessary to make the 
total number of 1 bits an odd 
number. 


opcode: See operation code. 


operand: A value to which an 
operator is applied. The value on 
which an opcode operates. 


operating system: The most 
fundamental program in a 
computer. It organizes the actions of 
the various parts of the computer 
and allows it to use other programs. 


operation code: The part of a 
machine-language instruction that 
specifies the operation to be 
performed. Often called opcode. 


operator: A symbol or sequence of 
characters, such as + or AND, 
specifying an operation to be 
performed on one or more values 
(the operands) to produce a result. 
See arithmetic operator, 
relational operator, logical 
operator, unary operator, 
binary operator. 


option: An argument that is 
optional. 


OR: A logical operator that 
produces a true result if either or 
both of its operands are true, a false 
result if both of its operands are 
false. Compare exclusive OR, 
AND, NOT. 
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output: Information transferred 
from a computer to some external 
destination, such as the display 
screen, a disk drive, a printer, or a 
modem. 


output routine: A 
machine-language routine that 
performs the sending of characters. 
The standard output routine writes 
characters to the screen. A different 
output routine might, for example, 
send them to a printer. 


overflow: The condition that 
exists when an attempt is made to 
put more data into a memory area 
than it can hold. 


override: To modify or cancel a 
long-standing instruction with a 
temporary one. 


overrun: A condition that occurs 
when the processor does not 
retrieve a received character from 
the receive data register of the 
ACIA before the subsequent 
character arrives. The ACIA 
automatically sets bit 2 (OVR) of its 
status register; subsequent 
characters are lost. The receive data 
register contains the last valid data 
word received. 
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page: (1) A segment of main 
memory 256 bytes long and 
beginning at an address that is an 
even multiple of 256 bytes. (2) An 
area of main memory containing 
text or graphical information being 
displayed on the screen. (3) A 
screenful of information on a video 
display. With the Apple Ile, a page 
consists of 24 lines of 40 or 80 
characters each. 


page zero: See zero page. 


parallel interface: An interface 
in which many bits of information 
(typically eight bits, or one byte) are 
transmitted simultaneously over 
different wires or channels. 
Compare serial interface. 


parity: Maintenance of a sameness 
of level or count, usually the count 
of 1 bit in each character, for error 
checking. 


Pascal: A high-level programming 
language with statements that 
resemble English sentences. Pascal 
was designed to teach programming 
as a systematic approach to problem 
solving. Named after the 
philosopher and mathematician, 
Blaise Pascal. 


pass: A single execution of a loop. 
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PC board: See printed-circuit 
board. 


peek: To read information directly 
from a location in the computer’s 
memory. 


peripheral: At or outside the 
boundaries of the computer itself, 
either physically (as a peripheral 
device) or in a logical sense (as a 
peripheral card). 


peripheral bus: The bus used for 
transmitting information between 
the computer and peripheral 
devices connected to the computer's 
expansion slots. 


peripheral card: A removable 
printed circuit board that plugs into 
one of the expansion slots in the 
Apple Ile. It expands or modifies the 
computer’s capabilities by 
connecting a peripheral device or 
performing some subsidiary or 
peripheral function. 


peripheral device: An auxiliary 
piece of equipment—such as a 
video monitor, disk drive, printer, or 
modem—used in conjunction with a 
computer and under the computer’s 
control. Often (but not necessarily ) 
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physically separate from the 
computer and connected to it by 
wires, cables, or some other form of 
interface, typically by means of a 
peripheral card. 


peripheral slot: See expansion 
slot. 


phase: (1) A stage in a periodic 
process. A point in a cycle. For 
example, the 65C02 micro processor 
uses a Clock cycle consisting of two 
phases called ¢0 and 1. (2) The 
relationship between two periodic 
signals or processes. For example, in 
NTSC color video, the color of a 
point on the screen is expressed by 
the instantaneous phase of the 
video signal relative to the color 
reference signal. 


PILOT: Acronym for 
Programmed Inquiry, Learning, 
Or Teaching. A high-level 
programming language designed to 
enable teachers to create 
computer-aided instruction (CAI) 
lessons that include color graphics, 
sound effects, lesson text, and 
answer checking. A version called 
Apple II PILOT is sold by Apple 
Computer for use with the Apple II 
family of computers. 


pipelining: A feature of a 
processor that enables it to begin 
fetching the next instruction before 
it has finished executing the current 
instruction. All else being equal, 
processors that have this feature 
run faster than those without it. 


plotting vector: A code 
representing a single step in 
drawing a shape on the 
high-resolution graphics screen, 
specifying whether to plot a point at 
the current screen position and in 
what direction to move (up, down, 
left, or right) before processing the 
next vector. 


point of call: The point ina 
program from which a subroutine or 
function is called. 


pointer: An item of information 
consisting of the memory address of 
some other item. For example, 
Applesoft maintains internal 
pointers to (among other things) the 
most recently stored variable, the 
most recently typed program line, 
and the most recently read data 
item. 


poke: To store information directly 
into a location in the computer’s 
memory. 


pop: To remove the top entry from 
a stack. 


power supply: A box that draws 
electrical power from a power outlet 
and converts it to the power the 
computer can use to do its 
computing. 


power supply case: The metal 
case inside the Apple Ile that houses 
the power supply. 


PR#: The PR# command sends 
output toa slot ora 
machine-language program. It 
specifies an output routine in the 
ROM on a peripheral card or in a 
machine-language routine in RAM 
by changing the address of the 
standard output routine used by the 
computer. 


precedence: The order in which 
operators are applied in evaluating 
an expression. 


printed-circuit board: A 
hardware component of a computer 
or other electronic device, 
consisting of a flat, rectangular 
piece of rigid material, commonly 
fiberglass, to which integrated 
circuits and other electronic 
components are connected. 
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procedure: In the Pascal 
programming language, a set of 
instructions that work as a unit; 
equivalent to the subprogram in 
BASIC. 


processor: The hardware 
component of a computer that 
performs the actual computation by 
directly executing instructions 
represented in machine language 
and stored in main memory. 


ProDOS: An Apple II operating 
system designed to support mass 
storage devices like the ProFile as 
well as flexible disk storage devices. 
ProDOS stands for Professional 
Disk Operating System. 


ProDOS command: Any one of 
the 28 commands recognized by 
ProDOS. Each has its own syntax, 
all can be used within programs, 
and all but five (text file 
commands) can be used from 
immediate mode. 


program: 7. A set of instructions 
describing actions for a computer to 
perform in order to accomplish some 
task, conforming to the rules and 
conventions of a particular 
programming language. In 
Applesoft, a sequence of program 
lines, each with a different line 
number. v. To write a program. 
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programmer: The author of a 
program; one who writes programs. 


programming: The activity of 
writing programs. 


programming language: A set of 
rules or conventions for writing 
programs. 


prompt: 7. A message on the 
screen. v. To remind or signal the 
user that some action is expected, 
typically by displaying a distinctive 
symbol, a reminder message, or a 
menu of choices on the display 
screen. 


prompt character: A text 
character displayed on the screen to 
prompt the user for some action. 
Often also identifies the program or 
component of the system that is 
doing the prompting: for example, 
the prompt character | is used by 
the Applesoft BASIC interpreter, > 
by Integer BASIC, and * by the 
system Monitor program. Also called 
prompting character. 


prompt line: A message displayed 
on the screen to prompt the user for 
some action. Also called prompting 
message. 


protocol: A set of rules for sending 
and receiving data on a 
communications line. 
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push: To add an entry to the top of 
a stack. 


queue: A list in which entries are 
added at one end and removed at 
the other, causing entries to be 
removed in FIFO (first-in first-out) 
order. Compare stack. 


radio-frequency modulator: A 
device that transforms your 
television set into a computer 
display device. 


RAM: See random-access 
memory. 


random-access memory (RAM): 
Memory in which the contents of 
individual locations can be referred 
to in an arbitrary or random order; 
the readable and writable memory 
of the Apple Ile. Its contents are 
usually filled with programs from a 
disk, and they are lost when the 
Apple Ile is turned off. This term is 
often used misleadingly to refer to 
read-write memory, but, strictly 
speaking, both read-only and 
read-write memory can be accessed 
in random order. Random-access 
means that each unit of storage has 
a unique address and a method by 
which each unit can be immediately 
read from or written to. Compare 
read-only memory, read-write 
memory. 
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random-access text file: A text 
file that is partitioned into an 
unlimited number of uniform-length 
compartments called records. When 
you open a random-access text file 
for the first time, you must specify 
its record length. No record is placed 
in the file until written to. Hach 
record can be individually read from 
or written to—hence, 
random-access. 


raster: The pattern of parallel 
lines making up the image ona 
video display screen. The image is 
produced by controlling the 
brightness of successive dots on the 
individual lines of the raster. 


read: To transfer information into 
the computer’s memory from a 
source external to the com puter 
(such as a disk drive or modem) or 
into the computer’s processor from a 
source external to the processor 
(such as the keyboard or main 
memory). 


read-only memory (ROM): 
Memory whose contents can be read 
but not written; used for storing 
firmware. Information is written 
into read-only memory once, during 
manufacture; it then remains there 
permanently, even when the 
computer's power is turned off, and 


can never be erased or changed. 
Compare random-access 
memory, read-write memory. 


read-write memory: Memory 
whose contents can be both read 
and written; often misleadingly 
called random-access memory, or 
RAM. The information contained in 
read-write memory is erased when 
the computer’s power is turned off, 
and is permanently lost unless it 
has been saved on a more 
permanent storage medium, such as 
a disk. Compare random-access 
memory, read-only memory. 


real number: A number that may 
include a fraction al part; 
represented inside the computer in 
floating-point form. Compare 
integer. 


register: A location in a computer 
processor where an item of 
information is held and modified 
under program control. 


relational operator: An operator, 
such as >, that compares numeric 
values to produce a logical result. 
Compare arithmetic operator, 
logical operator. 


reserved word: A word or 
sequence of characters reserved by 
a programming language for some 
special use, and therefore 
unavailable as a variable name in a 
program. 


resident: See memory-resident, 
disk-resident. 


return address: The point ina 
program to which control returns on 
completion of a subroutine or 
function. 


RF modulator: See 
radio-frequency modulator. 


ROM: See read-only memory. 


routine: A part of a program that 
accomplishes some task subordinate 
to the overall task of the program. 


row: A horizontal arrangement of 
character spaces or graphics points 
on the screen. 


RS232 cable: Any cable that is 

wired in accordance with the RS232 
standard, which is the common data 
communications interface standard. 


run: (1) To execute a program. 
(2) To load a program into main 
memory from a peripheral storage 
medium, such as a disk, and 
execute It. 
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save: To transfer information from 
main memory to a peripheral 
storage medium for later use. 


scroll: To change the contents of 
all or part of the display screen by 
shifting information out at one end 
(most often the top) to make room 
for new information appearing at 
the other end (most often the 
bottom), producing an effect like 
that of moving a scroll of paper past 
a fixed viewing window. See 
window. 


serial interface: An interface in 
which information is transmitted 
sequentially, one bit at a time, over 
a single wire or channel. Compare 
parallel interface. 


setup time: The amount of time a 
signal must be valid in advance of 
some event. Compare hold time. 


silicon: A non-metallic, 
semiconducting chemical element 
from which integrated circuits are 
made. Not to be confused with 
silica—that is, silicon dioxide, such 
as quartz, opal, or sand—or with 
silicone, any of a group of organic 
compounds containing silicon. 
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simple variable: A variable that is 
not an element of an array. 


simplified keyboard: The 
Dvorak keyboard. 


6502: The type of microprocessor 
used in the Apple II, I] Plus, and 
original Ile. 


65C02: The type of microprocessor 
used in the enchanced Apple Ile and 
the Apple IIc. 


slot: A narrow socket inside the 
computer where you can install 
peripheral device cards. 


soft switch: A means of changing 
some feature of the computer from 
within a program; specifically, a 
location in memory that produces 
some special effect whenever its 
contents are read or written. 


software: Instructions that tell the 
computer what to do. They're 
usually stored on disks. Compare 
hardware, firmware. 


source program: The original 
form of a program given to a 
language translator such as a 
compiler or assembler for 
conversion into another form; 
sometimes called source code. 
Compare object program. 
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space character: A text character 
whose printed representation is a 
blank space, typed by pressing the 
bar. 


stack: A list in which entries are 
added or removed at one end only 
(the top of the stack), causing them 
to be removed in LIFO (last-in 
first-out) order. Compare queue. 


standard instruction: An 
instruction automatically present 
when no superseding instruction 
has been received. 


start up: To get the system 
running. For example, In the 
context of ProDOS, starting up is the 
process of reading the ProDOS 
program (in the files PRODOS and 
BASIC.SYSTEM) from the disk, and 
running it. 


starting value: The value 
assigned to the index variable on 
the first pass through a loop. 


startup disk: A disk containing an 
operating system and a self-starting 
program. 


statement: A unit of a program in 
a high-level language that specifies 
an action for the computer to 
perform, typically corresponding to 
several instructions of machine 
language. 
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step value: The amount by which 
the index variable changes on each 
pass through a loop. 


string: An item of information 
consisting of a sequence of text 
characters. 


strobe: A signal whose change is 
used to trigger some action. 


subroutine: A part of a program 
that can be executed on request 
from any point in the program, and 
which returns control to the point of 
the request on completion. 


synchronous transmission: A 
transmission process that requires 
an integral number of unit (time) 
intervals between any two 
significant instances. In 
synchronous communications, the 
transmitter and receiver are in step 
with each other, and characters 
being transmitted follow one after 
the other at regular intervals. 
Compare asynchronous 
transmission. 


syntax: The rules governing the 
structure of statements or 
instructions in a programming 
language; a representation of a 
command that specifies al the 
possible forms the command can 
take. 


system: A coordinated collection of 
interrelated and interacting parts 
organized to perform some function 
or achieve some purpose. 


system configuration: See 
configuration. 


system program: A program that 
makes the resources and 
capabilities of the computer 
available for general purposes, such 
as an operating system or a 
language translator. Compare 
application pro gram. 


system software: The component 
of a computer system consisting of 
system programs. 


TAB: An ASCII character that 
commands a device such as a 
printer to start printing at a preset 
location (called a tab stop). There 
are two such characters;: horizontal 
tab (hex $09) and vertical tab (hex 
SOB). 


television set: A display device 
capable of receiving broadcast video 
signals (such as commercial 
television) by means of an antenna. 
Can be used in combination with a 
radio-frequency modulator as a 
display device for the Apple Ile. 
Compare video monitor. 


terminal: A device consisting of a 
typewriter-like keyboard and a 
display device, used for 
communicating between a computer 
system and a human user. Personal 
computers such as those in the 
Apple II family of computers 
typically have all or part of a 
terminal built into them. 


text: (1) Information presented in 
the form of characters readable by 
humans. (2) The display of 
characters on a display screen. 
Compare graphics. 


text window: An area on the video 
display screen within which text is 
displayed and scrolled. 


traces: Electrical roads that 
connect the components on a circuit 
board. 


transistor-transistor logic 
(TTL): (1) A type of integrated 
circuit used in computers and 
related devices. (2) A standard for 
interconnecting such circuits that 
defines the voltages used to 
represent logical zeros and ones. 


troubleshoot: To locate and 
correct the cause of a problem or 
malfunction in a computer system. 
Typically used to refer to 
hardware-related problems. 
Compare debug. 
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TTL: See transistor-transistor 
logic. 


turnkey disk: A disk that 
executes a specific application 
program when you use that disk to 
start the computer. 


turnkey program: A program, 
such as a game or application, that 
runs automatically when the disk 
that the program is on is used to 
start up the computer. 


unary operator: An operator that 
applies to a single operand; for 
example, the minus sign (-) in a 
negative number such as -6 is a 
unary arithmetic operator. Compare 
binary operator. 


unconditional branch: A branch 
that does not depend on the truth of 
any condition. Compare 
conditional branch. 


value: An item of information that 
can be stored in a variable, such as a 
number or a string. 


variable: (1) A location in the 
computer’s memory where a value 
can be stored. (2) The symbol used 
in a program to represent such a 
location. Compare constant. 
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vector: (1) The starting address of 
a program segment, when used as a 
common point for transferring 
control from other programs. (2) A 
memory location used to hold a 
vector, or the address of such a 
location. 


video: (1) A medium for 
transmitting information in the form 
of images to be displayed on the 
screen of a cathode-ray tube. (2) 
Information organized or 
transmitted in video form. 


video monitor: A display device 
capable of receiving video signals by 
direct connection only, and which 
cannot receive broadcast signals 
such as commercial television. Can 
be connected directly to the 
computer as a display device. 
Compare television receiver. 


volume: A general term referring 
to a storage device; a source or 
destination of information. A 
volume has a name and a volume 
directory with the same name. Its 
information is organized into files. 


window: The portion of a 
collection of information (such as a 
document, picture, or worksheet) 
that is visible on the display screen. 
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word: A group of bits of a fixed size 
that is treated as a unit; the number 
of bits in a word is a characteristic 
of each particular computer. 


write: To transfer information 
from the computer to a destination 
external to the computer (such as a 
disk drive, printer, or modem) or 
from the computer’s processor to a 
destination external to the processor 
(such as main memory ). 


write-enable notch: The square 
cutout on one edge of a disk’s jacket 
that permits information to be 
written on the disk. If there is no 
write-enable notch, or if it is covered 
with a write-protect tab, 
information can be read from the 
disk but not written onto it. 


write-protect: To protect the 
information on a disk by covering 
the write-enable notch with a 
write-protect tab, preventing any 
new information from being written 
onto the disk. Compare copy 
protect. 


write-protect tab: A small 
adhesive sticker used to 
write-protect a disk by covering the 
write-enable notch. 


Glossary 


X register: One of the index 
registers in the 65C02 
microprocessor. 


Y register: One of the index 
registers in the 65C02 
microprocessor. 


zero page: The first page (256 
bytes) of memory in the Apple Ile, 
also called page zero. Since the 
high-order byte of any address in 
this page is zero, only the low-order 
byte is needed to specify a zero-page 
address; this makes zero-page 
locations more efficient to address, 
in both time and space, than 
locations in any other page of 
memory. 
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